home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1995 February: Tool Chest / Dev.CD Feb 95 / Dev.CD Feb 95.toast / Tool Chest / Games / Mac Game Developer's Handbook / Sound and Midi / Audio - Jim Reekes next >
MacBinary  |  1993-04-22  |  92.0 KB  |  [ONLN/HLX2]

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: MacBinary (archive/macBinary).

ConfidenceProgramDetectionMatch TypeSupport
10% dexvert MacBinary (archive/macBinary) fallback Supported
100% file MacBinary II, inited, Thu Apr 22 06:42:18 1993, modified Thu Apr 22 06:42:23 1993, creator 'HLX2', type 'ONLN', 91414 bytes "Audio - Jim Reekes" , at 0x16596 2450 bytes resource default (weak)
99% file data default
100% TrID MacBinary 2 default (weak)
100% siegfried fmt/1762 MacBinary (II) default
100% lsar MacBinary default


id metadata
keyvalue
macFileType[ONLN]
macFileCreator[HLX2]



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 12 41 75 64 69 6f 20 | 2d 20 4a 69 6d 20 52 65 |..Audio |- Jim Re|
|00000010| 65 6b 65 73 00 00 00 00 | 00 00 00 00 00 00 00 00 |ekes....|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 01 65 16 00 | 00 09 92 a7 fc 27 0a a7 |.....e..|.....'..|
|00000060| fc 27 0f 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.'......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 a4 e2 00 00 |........|........|
|00000080| 41 75 64 69 6f 20 41 6e | 61 72 63 68 79 0d 42 79 |Audio An|archy.By|
|00000090| 20 4a 69 6d 20 52 65 65 | 6b 65 73 0d 49 6e 74 72 | Jim Ree|kes.Intr|
|000000a0| 6f 64 75 63 74 69 6f 6e | 0d 54 68 69 73 20 64 6f |oduction|.This do|
|000000b0| 63 75 6d 65 6e 74 20 6c | 69 73 74 73 20 61 6c 6c |cument l|ists all|
|000000c0| 20 6f 66 20 74 68 65 20 | 73 6f 75 6e 64 20 63 6f | of the |sound co|
|000000d0| 6d 6d 61 6e 64 73 20 61 | 6e 64 20 74 68 65 69 72 |mmands a|nd their|
|000000e0| 20 64 65 66 69 6e 65 64 | 20 62 65 68 61 76 69 6f | defined| behavio|
|000000f0| 72 2e 20 20 49 d5 76 65 | 20 69 6e 63 6c 75 64 65 |r. I.ve| include|
|00000100| 64 20 73 6f 6d 65 20 68 | 69 73 74 6f 72 69 63 61 |d some h|istorica|
|00000110| 6c 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 61 6e |l inform|ation an|
|00000120| 64 20 62 75 67 73 20 69 | 6e 20 61 64 64 69 74 69 |d bugs i|n additi|
|00000130| 6f 6e 2e 20 20 44 61 74 | 61 20 63 6f 6d 6d 61 6e |on. Dat|a comman|
|00000140| 64 73 20 77 69 6c 6c 20 | 73 75 70 70 6c 79 20 64 |ds will |supply d|
|00000150| 61 74 61 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ata info|rmation |
|00000160| 74 6f 20 74 68 65 20 53 | 6f 75 6e 64 20 4d 61 6e |to the S|ound Man|
|00000170| 61 67 65 72 2e 20 20 43 | 6f 6e 74 72 6f 6c 20 63 |ager. C|ontrol c|
|00000180| 6f 6d 6d 61 6e 64 73 20 | 77 69 6c 6c 20 63 6f 6e |ommands |will con|
|00000190| 74 72 6f 6c 20 74 68 65 | 20 66 6c 6f 77 20 6f 66 |trol the| flow of|
|000001a0| 20 74 68 65 20 64 61 74 | 61 20 61 6e 64 20 6d 61 | the dat|a and ma|
|000001b0| 79 20 63 68 61 6e 67 65 | 20 74 68 65 20 62 65 68 |y change| the beh|
|000001c0| 61 76 69 6f 72 20 6f 66 | 20 74 68 65 20 73 6f 75 |avior of| the sou|
|000001d0| 6e 64 20 63 68 61 6e 6e | 65 6c 2e 20 20 53 74 61 |nd chann|el. Sta|
|000001e0| 74 75 73 20 63 6f 6d 6d | 61 6e 64 73 20 77 69 6c |tus comm|ands wil|
|000001f0| 6c 20 72 65 74 75 72 6e | 20 69 6e 66 6f 72 6d 61 |l return| informa|
|00000200| 74 69 6f 6e 20 61 62 6f | 75 74 20 74 68 65 20 53 |tion abo|ut the S|
|00000210| 6f 75 6e 64 20 4d 61 6e | 61 67 65 72 2e 20 20 54 |ound Man|ager. T|
|00000220| 68 65 72 65 20 61 72 65 | 20 6d 6f 72 65 20 64 65 |here are| more de|
|00000230| 66 69 6e 65 64 20 69 6e | 20 74 68 65 20 6f 72 69 |fined in| the ori|
|00000240| 67 69 6e 61 6c 20 64 6f | 63 75 6d 65 6e 74 61 74 |ginal do|cumentat|
|00000250| 69 6f 6e 20 61 6e 64 20 | 63 6f 6e 74 69 6e 75 65 |ion and |continue|
|00000260| 20 74 6f 20 61 70 70 65 | 61 72 20 69 6e 20 74 68 | to appe|ar in th|
|00000270| 65 20 4d 50 57 20 69 6e | 74 65 72 66 61 63 65 73 |e MPW in|terfaces|
|00000280| 20 74 68 61 6e 20 74 68 | 65 20 6f 6e 65 73 20 69 | than th|e ones i|
|00000290| 6d 6d 65 64 69 61 74 65 | 6c 79 20 6c 69 73 74 65 |mmediate|ly liste|
|000002a0| 64 20 62 65 6c 6f 77 2e | 20 20 54 68 65 79 20 77 |d below.| They w|
|000002b0| 65 72 65 20 6c 65 66 74 | 20 69 6e 20 74 68 65 20 |ere left| in the |
|000002c0| 69 6e 74 65 72 66 61 63 | 65 73 20 74 6f 20 61 6c |interfac|es to al|
|000002d0| 6c 6f 77 20 64 65 76 65 | 6c 6f 70 65 72 73 20 74 |low deve|lopers t|
|000002e0| 68 61 74 20 6d 61 79 20 | 62 65 20 64 65 62 75 67 |hat may |be debug|
|000002f0| 67 69 6e 67 20 63 6f 64 | 65 20 74 6f 20 75 6e 64 |ging cod|e to und|
|00000300| 65 72 73 74 61 6e 64 20 | 77 68 61 74 20 63 6f 6d |erstand |what com|
|00000310| 6d 61 6e 64 73 20 6d 69 | 67 68 74 20 62 65 20 69 |mands mi|ght be i|
|00000320| 73 73 75 65 64 20 69 6e | 74 65 72 6e 61 6c 6c 79 |ssued in|ternally|
|00000330| 2e 20 20 54 68 65 73 65 | 20 75 6e 64 6f 63 75 6d |. These| undocum|
|00000340| 65 6e 74 65 64 20 63 6f | 6d 6d 61 6e 64 73 20 61 |ented co|mmands a|
|00000350| 72 65 20 6e 6f 74 20 74 | 6f 20 62 65 20 75 73 65 |re not t|o be use|
|00000360| 64 2e 0d 09 20 20 20 20 | 20 20 20 20 20 20 20 20 |d... | |
|00000370| 4c 49 53 54 20 4f 46 20 | 53 4f 55 4e 44 20 43 4f |LIST OF |SOUND CO|
|00000380| 4d 4d 41 4e 44 53 09 09 | 0d 09 09 09 0d 44 61 74 |MMANDS..|.....Dat|
|00000390| 61 20 63 6f 6d 6d 61 6e | 64 73 09 43 6f 6e 74 72 |a comman|ds.Contr|
|000003a0| 6f 6c 20 63 6f 6d 6d 61 | 6e 64 73 09 53 74 61 74 |ol comma|nds.Stat|
|000003b0| 75 73 20 63 6f 6d 6d 61 | 6e 64 73 09 0d 62 75 66 |us comma|nds..buf|
|000003c0| 66 65 72 43 6d 64 09 61 | 6d 70 43 6d 64 09 63 61 |ferCmd.a|mpCmd.ca|
|000003d0| 6c 6c 42 61 63 6b 43 6d | 64 09 0d 63 6f 6e 74 69 |llBackCm|d..conti|
|000003e0| 6e 75 65 43 6d 64 09 61 | 76 61 69 6c 61 62 6c 65 |nueCmd.a|vailable|
|000003f0| 43 6d 64 09 67 65 74 41 | 6d 70 43 6d 64 09 0d 66 |Cmd.getA|mpCmd..f|
|00000400| 72 65 71 43 6d 64 20 28 | 3f 63 6f 6e 74 72 6f 6c |reqCmd (|?control|
|00000410| 3f 29 09 66 6c 75 73 68 | 43 6d 64 09 67 65 74 52 |?).flush|Cmd.getR|
|00000420| 61 74 65 43 6d 64 09 0d | 66 72 65 71 44 75 72 61 |ateCmd..|freqDura|
|00000430| 74 69 6f 6e 43 6d 64 20 | 28 3f 63 6f 6e 74 72 6f |tionCmd |(?contro|
|00000440| 6c 3f 29 09 6e 75 6c 6c | 43 6d 64 09 6c 6f 61 64 |l?).null|Cmd.load|
|00000450| 43 6d 64 09 0d 73 6f 75 | 6e 64 43 6d 64 09 70 61 |Cmd..sou|ndCmd.pa|
|00000460| 75 73 65 43 6d 64 09 74 | 6f 74 61 6c 4c 6f 61 64 |useCmd.t|otalLoad|
|00000470| 43 6d 64 09 0d 77 61 76 | 65 54 61 62 6c 65 43 6d |Cmd..wav|eTableCm|
|00000480| 64 09 71 75 69 65 74 43 | 6d 64 09 76 65 72 73 69 |d.quietC|md.versi|
|00000490| 6f 6e 43 6d 64 09 0d 09 | 72 61 74 65 43 6d 64 09 |onCmd...|rateCmd.|
|000004a0| 09 0d 09 72 65 49 6e 69 | 74 43 6d 64 09 09 0d 09 |...reIni|tCmd....|
|000004b0| 72 65 73 74 43 6d 64 09 | 09 0d 09 72 65 73 75 6d |restCmd.|...resum|
|000004c0| 65 43 6d 64 09 09 0d 09 | 73 79 6e 63 43 6d 64 09 |eCmd....|syncCmd.|
|000004d0| 09 0d 09 74 69 6d 62 72 | 65 43 6d 64 09 09 0d 09 |...timbr|eCmd....|
|000004e0| 77 61 69 74 43 6d 64 09 | 09 0d 0d 54 68 65 20 6f |waitCmd.|...The o|
|000004f0| 6e 6c 79 20 6f 6e 65 73 | 20 73 75 70 70 6f 72 74 |nly ones| support|
|00000500| 65 64 20 61 72 65 20 74 | 68 65 73 65 20 64 61 74 |ed are t|hese dat|
|00000510| 61 2c 20 63 6f 6e 74 72 | 6f 6c 2c 20 61 6e 64 20 |a, contr|ol, and |
|00000520| 73 74 61 74 75 73 20 63 | 6f 6d 6d 61 6e 64 73 20 |status c|ommands |
|00000530| 69 6e 20 74 68 65 20 74 | 61 62 6c 65 20 62 65 6c |in the t|able bel|
|00000540| 6f 77 2e 20 20 0d 4f 74 | 68 65 72 20 61 64 64 69 |ow. .Ot|her addi|
|00000550| 74 69 6f 6e 61 6c 20 63 | 6f 6d 6d 61 6e 64 73 20 |tional c|ommands |
|00000560| 61 72 65 20 64 65 66 69 | 6e 65 64 20 6c 61 74 65 |are defi|ned late|
|00000570| 72 20 61 6e 64 20 61 72 | 65 20 70 72 65 73 65 6e |r and ar|e presen|
|00000580| 74 65 64 20 68 65 72 65 | 20 6f 6e 6c 79 20 66 6f |ted here| only fo|
|00000590| 72 20 63 6f 6d 70 6c 65 | 74 65 6e 65 73 73 20 73 |r comple|teness s|
|000005a0| 61 6b 65 2e 20 20 4d 61 | 6e 79 20 6f 66 20 74 68 |ake. Ma|ny of th|
|000005b0| 65 73 65 20 61 72 65 20 | 75 73 65 64 20 70 72 69 |ese are |used pri|
|000005c0| 76 61 74 65 6c 79 20 62 | 79 20 74 68 65 20 53 6f |vately b|y the So|
|000005d0| 75 6e 64 20 4d 61 6e 61 | 67 65 72 20 61 6e 64 20 |und Mana|ger and |
|000005e0| 73 68 6f 75 6c 64 20 6e | 6f 74 20 62 65 20 69 73 |should n|ot be is|
|000005f0| 73 75 65 64 20 62 79 20 | 61 70 70 6c 69 63 61 74 |sued by |applicat|
|00000600| 69 6f 6e 73 20 28 65 76 | 65 6e 20 74 68 6f 75 67 |ions (ev|en thoug|
|00000610| 68 20 74 68 65 79 20 77 | 65 72 65 20 64 6f 63 75 |h they w|ere docu|
|00000620| 6d 65 6e 74 65 64 20 62 | 79 20 74 68 65 20 49 6e |mented b|y the In|
|00000630| 73 69 64 65 20 4d 61 63 | 20 56 20 61 6e 64 20 72 |side Mac| V and r|
|00000640| 65 70 6c 61 63 65 6d 65 | 6e 74 20 63 68 61 70 74 |eplaceme|nt chapt|
|00000650| 65 72 20 6f 66 20 49 6e | 73 69 64 65 20 4d 61 63 |er of In|side Mac|
|00000660| 20 70 75 62 6c 69 73 68 | 65 64 20 4f 63 74 2e 20 | publish|ed Oct. |
|00000670| 32 2c 20 31 39 38 38 29 | 2e 0d 49 4d 50 4f 52 54 |2, 1988)|..IMPORT|
|00000680| 41 4e 54 20 4e 4f 54 45 | 53 0d 53 69 6e 63 65 20 |ANT NOTE|S.Since |
|00000690| 74 68 65 20 68 69 67 68 | 20 62 79 74 65 20 6f 66 |the high| byte of|
|000006a0| 20 70 61 72 61 6d 32 20 | 77 61 73 20 64 6f 63 75 | param2 |was docu|
|000006b0| 6d 65 6e 74 65 64 20 61 | 73 20 62 65 69 6e 67 20 |mented a|s being |
|000006c0| 75 73 65 64 20 66 6f 72 | 20 61 6e 20 61 6d 70 6c |used for| an ampl|
|000006d0| 69 74 75 64 65 20 76 61 | 6c 75 65 20 62 75 74 20 |itude va|lue but |
|000006e0| 68 61 73 20 6e 65 76 65 | 72 20 62 65 65 6e 20 69 |has neve|r been i|
|000006f0| 6d 70 6c 65 6d 65 6e 74 | 65 64 2c 20 77 65 20 68 |mplement|ed, we h|
|00000700| 61 76 65 20 61 20 70 72 | 6f 62 6c 65 6d 2e 20 20 |ave a pr|oblem. |
|00000710| 49 66 20 77 65 20 73 74 | 61 72 74 20 75 73 69 6e |If we st|art usin|
|00000720| 67 20 69 74 2c 20 77 65 | 20 68 61 76 65 20 6e 6f |g it, we| have no|
|00000730| 20 69 64 65 61 20 77 68 | 61 74 20 76 61 6c 75 65 | idea wh|at value|
|00000740| 73 20 61 72 65 20 62 65 | 69 6e 67 20 70 61 73 73 |s are be|ing pass|
|00000750| 65 64 20 74 6f 20 74 68 | 65 20 53 6f 75 6e 64 20 |ed to th|e Sound |
|00000760| 4d 61 6e 61 67 65 72 2e | 20 20 57 65 20 68 61 76 |Manager.| We hav|
|00000770| 65 20 74 77 6f 20 63 68 | 6f 69 63 65 73 3a 20 6e |e two ch|oices: n|
|00000780| 65 76 65 72 20 75 73 65 | 20 74 68 65 20 68 69 67 |ever use| the hig|
|00000790| 68 20 62 79 74 65 20 6f | 72 20 73 74 61 72 74 20 |h byte o|r start |
|000007a0| 75 73 69 6e 67 20 69 74 | 2e 20 20 49 66 20 77 65 |using it|. If we|
|000007b0| 20 73 74 61 72 74 20 70 | 61 79 69 6e 67 20 61 74 | start p|aying at|
|000007c0| 74 65 6e 74 69 6f 6e 20 | 74 6f 20 74 68 65 20 61 |tention |to the a|
|000007d0| 6d 70 6c 69 74 75 64 65 | 20 76 61 6c 75 65 20 69 |mplitude| value i|
|000007e0| 74 20 63 6f 75 6c 64 20 | 70 72 65 73 65 6e 74 20 |t could |present |
|000007f0| 6f 6e 65 20 70 72 6f 62 | 6c 65 6d 2c 20 d2 77 68 |one prob|lem, .wh|
|00000800| 61 74 20 69 66 20 69 74 | d5 73 20 6e 6f 74 20 77 |at if it|.s not w|
|00000810| 68 61 74 20 74 68 65 20 | 64 65 76 65 6c 6f 70 65 |hat the |develope|
|00000820| 72 20 77 61 73 20 65 78 | 70 65 63 74 69 6e 67 2e |r was ex|pecting.|
|00000830| d3 20 20 46 6f 72 20 65 | 78 61 6d 70 6c 65 2c 20 |. For e|xample, |
|00000840| 77 68 61 74 20 69 66 20 | 74 68 65 79 20 70 61 73 |what if |they pas|
|00000850| 73 65 64 20 7a 65 72 6f | 20 69 6e 20 74 68 65 20 |sed zero| in the |
|00000860| 68 69 67 68 20 62 79 74 | 65 3f 20 20 54 68 65 6e |high byt|e? Then|
|00000870| 20 74 68 65 20 73 6f 75 | 6e 64 20 77 6f 75 6c 64 | the sou|nd would|
|00000880| 20 6e 65 76 65 72 20 62 | 65 20 68 65 61 72 64 2e | never b|e heard.|
|00000890| 0d 61 6d 70 43 6d 64 0d | 70 61 72 61 6d 31 09 64 |.ampCmd.|param1.d|
|000008a0| 65 73 69 72 65 64 20 61 | 6d 70 6c 69 74 75 64 65 |esired a|mplitude|
|000008b0| 0d 70 61 72 61 6d 32 09 | 30 20 28 69 67 6e 6f 72 |.param2.|0 (ignor|
|000008c0| 65 64 20 6f 6e 20 69 6e | 70 75 74 20 61 6e 64 20 |ed on in|put and |
|000008d0| 6f 75 74 70 75 74 29 0d | 43 68 61 6e 67 65 73 20 |output).|Changes |
|000008e0| 74 68 65 20 61 6d 70 6c | 69 74 75 64 65 20 28 6f |the ampl|itude (o|
|000008f0| 72 20 6c 6f 75 64 6e 65 | 73 73 29 20 6f 66 20 61 |r loudne|ss) of a|
|00000900| 20 73 6f 75 6e 64 2e 20 | 49 66 20 6e 6f 20 73 6f | sound. |If no so|
|00000910| 75 6e 64 20 69 73 20 63 | 75 72 72 65 6e 74 6c 79 |und is c|urrently|
|00000920| 20 70 6c 61 79 69 6e 67 | 2c 20 74 68 65 6e 20 61 | playing|, then a|
|00000930| 6d 70 43 6d 64 20 73 65 | 74 73 20 74 68 65 20 61 |mpCmd se|ts the a|
|00000940| 6d 70 6c 69 74 75 64 65 | 20 6f 66 20 74 68 65 20 |mplitude| of the |
|00000950| 6e 65 78 74 20 73 6f 75 | 6e 64 20 74 6f 20 62 65 |next sou|nd to be|
|00000960| 20 70 6c 61 79 65 64 2e | 20 54 68 65 20 61 6d 70 | played.| The amp|
|00000970| 6c 69 74 75 64 65 20 69 | 73 20 73 65 6e 74 20 69 |litude i|s sent i|
|00000980| 6e 20 70 61 72 61 6d 31 | 20 61 6e 64 20 73 68 6f |n param1| and sho|
|00000990| 75 6c 64 20 62 65 20 61 | 6e 20 69 6e 74 65 67 65 |uld be a|n intege|
|000009a0| 72 20 69 6e 20 74 68 65 | 20 72 61 6e 67 65 20 30 |r in the| range 0|
|000009b0| 20 74 6f 20 32 35 35 2e | 20 59 6f 75 20 63 61 6e | to 255.| You can|
|000009c0| 20 73 65 6e 64 20 61 6d | 70 43 6d 64 20 74 6f 20 | send am|pCmd to |
|000009d0| 61 6e 79 20 6f 66 20 74 | 68 65 20 61 76 61 69 6c |any of t|he avail|
|000009e0| 61 62 6c 65 20 73 79 6e | 74 68 65 73 69 7a 65 72 |able syn|thesizer|
|000009f0| 73 2e 0d 53 71 75 61 72 | 65 57 61 76 65 53 6e 74 |s..Squar|eWaveSnt|
|00000a00| 68 0d 49 66 20 74 68 65 | 20 63 68 61 6e 6e 65 6c |h.If the| channel|
|00000a10| 20 77 61 73 20 66 6f 72 | 20 74 68 65 20 73 71 75 | was for| the squ|
|00000a20| 61 72 65 57 61 76 65 53 | 6e 74 68 20 28 66 6f 72 |areWaveS|nth (for|
|00000a30| 6d 61 6c 6c 79 20 6b 6e | 6f 77 6e 20 61 73 20 74 |mally kn|own as t|
|00000a40| 68 65 20 6e 6f 74 65 53 | 6e 74 68 29 20 74 68 65 |he noteS|nth) the|
|00000a50| 6e 20 69 74 20 77 6f 75 | 6c 64 20 61 66 66 65 63 |n it wou|ld affec|
|00000a60| 74 20 74 68 65 20 73 6f | 75 6e 64 20 71 75 61 6c |t the so|und qual|
|00000a70| 69 74 79 2e 20 20 49 74 | 20 64 69 64 6e d5 74 20 |ity. It| didn.t |
|00000a80| 63 68 61 6e 67 65 20 74 | 68 65 20 76 6f 6c 75 6d |change t|he volum|
|00000a90| 65 2c 20 61 74 20 6c 65 | 61 73 74 20 6e 6f 74 20 |e, at le|ast not |
|00000aa0| 74 6f 20 6d 79 20 65 61 | 72 73 20 69 74 20 64 69 |to my ea|rs it di|
|00000ab0| 64 6e d5 74 2e 20 20 4f | 6e 20 74 68 65 20 4d 61 |dn.t. O|n the Ma|
|00000ac0| 63 20 50 6c 75 73 20 61 | 6e 64 20 73 69 6d 69 6c |c Plus a|nd simil|
|00000ad0| 61 72 20 68 61 72 64 77 | 61 72 65 20 74 68 69 73 |ar hardw|are this|
|00000ae0| 20 77 6f 75 6c 64 20 63 | 61 75 73 65 20 6c 6f 74 | would c|ause lot|
|00000af0| 73 20 6f 66 20 6e 6f 69 | 73 65 20 62 65 63 61 75 |s of noi|se becau|
|00000b00| 73 65 20 74 68 65 20 73 | 71 75 61 72 65 57 61 76 |se the s|quareWav|
|00000b10| 65 53 6e 74 68 20 69 73 | 20 61 63 63 6f 6d 70 6c |eSnth is| accompl|
|00000b20| 69 73 68 65 64 20 62 79 | 20 75 73 69 6e 67 20 77 |ished by| using w|
|00000b30| 61 76 65 20 74 61 62 6c | 65 20 73 79 6e 74 68 65 |ave tabl|e synthe|
|00000b40| 73 69 73 65 73 20 61 6e | 64 20 74 68 65 20 61 6d |sises an|d the am|
|00000b50| 70 6c 69 74 75 64 65 20 | 63 68 61 6e 67 65 20 61 |plitude |change a|
|00000b60| 66 66 65 63 74 73 20 74 | 68 65 20 73 68 61 70 65 |ffects t|he shape|
|00000b70| 20 6f 66 20 74 68 65 20 | 77 61 76 65 20 62 65 69 | of the |wave bei|
|00000b80| 6e 67 20 75 73 65 64 2e | 20 20 42 75 74 20 74 68 |ng used.| But th|
|00000b90| 65 20 4d 61 63 20 50 6c | 75 73 20 68 61 73 20 6e |e Mac Pl|us has n|
|00000ba0| 6f 20 68 61 72 64 77 61 | 72 65 20 73 75 70 70 6f |o hardwa|re suppo|
|00000bb0| 72 74 20 66 6f 72 20 74 | 68 69 73 20 61 6e 64 20 |rt for t|his and |
|00000bc0| 61 63 63 6f 6d 70 6c 69 | 73 68 65 73 20 74 68 65 |accompli|shes the|
|00000bd0| 20 73 79 6e 74 68 65 69 | 73 65 73 20 65 6e 74 69 | synthei|ses enti|
|00000be0| 72 65 6c 79 20 69 6e 20 | 73 6f 66 74 77 61 72 65 |rely in |software|
|00000bf0| 2e 20 20 53 6f 20 77 68 | 69 6c 65 20 74 68 65 20 |. So wh|ile the |
|00000c00| 73 6f 75 6e 64 20 64 61 | 74 61 20 69 73 20 62 65 |sound da|ta is be|
|00000c10| 69 6e 67 20 72 65 61 64 | 20 62 79 20 74 68 65 20 |ing read| by the |
|00000c20| 68 61 72 64 77 61 72 65 | 2c 20 74 68 65 20 73 6f |hardware|, the so|
|00000c30| 66 74 77 61 72 65 20 69 | 73 20 61 74 74 65 6d 70 |ftware i|s attemp|
|00000c40| 74 69 6e 67 20 74 6f 20 | 63 68 61 6e 67 65 20 74 |ting to |change t|
|00000c50| 68 65 20 77 61 76 65 20 | 64 61 74 61 20 61 6e 64 |he wave |data and|
|00000c60| 20 74 68 69 73 20 69 73 | 20 77 68 61 74 20 63 61 | this is| what ca|
|00000c70| 75 73 65 64 20 74 68 65 | 20 73 63 72 61 74 63 68 |used the| scratch|
|00000c80| 79 20 73 6f 75 6e 64 2e | 0d 4f 6e 20 6d 61 63 68 |y sound.|.On mach|
|00000c90| 69 6e 65 73 20 77 69 74 | 68 20 74 68 65 20 41 70 |ines wit|h the Ap|
|00000ca0| 70 6c 65 20 53 6f 75 6e | 64 20 43 68 69 70 20 74 |ple Soun|d Chip t|
|00000cb0| 68 65 20 73 79 6e 74 68 | 65 73 69 73 65 73 20 69 |he synth|esises i|
|00000cc0| 73 20 68 61 6e 64 6c 65 | 64 20 62 79 20 74 68 65 |s handle|d by the|
|00000cd0| 20 68 61 72 64 77 61 72 | 65 2e 20 20 43 68 61 6e | hardwar|e. Chan|
|00000ce0| 67 69 6e 67 20 74 68 65 | 20 77 61 76 65 20 73 68 |ging the| wave sh|
|00000cf0| 61 70 65 20 61 74 20 74 | 68 65 20 73 61 6d 65 20 |ape at t|he same |
|00000d00| 74 69 6d 65 20 69 74 20 | 69 73 20 62 65 69 6e 67 |time it |is being|
|00000d10| 20 75 73 65 64 20 77 69 | 6c 6c 20 6e 6f 74 20 61 | used wi|ll not a|
|00000d20| 66 66 65 63 74 20 74 68 | 65 20 6f 75 74 70 75 74 |ffect th|e output|
|00000d30| 2e 20 20 41 6e 20 65 78 | 61 6d 70 6c 65 20 6f 66 |. An ex|ample of|
|00000d40| 20 74 68 65 20 61 6d 70 | 6c 69 74 75 64 65 20 63 | the amp|litude c|
|00000d50| 68 61 6e 67 65 20 6f 6e | 20 61 20 73 71 75 61 72 |hange on| a squar|
|00000d60| 65 57 61 76 65 53 6e 74 | 68 20 63 61 6e 20 62 65 |eWaveSnt|h can be|
|00000d70| 20 68 65 61 72 64 20 77 | 68 65 6e 20 79 6f 75 20 | heard w|hen you |
|00000d80| 70 6c 61 79 20 53 69 6d | 70 6c 65 20 42 65 65 70 |play Sim|ple Beep|
|00000d90| 20 66 72 6f 6d 20 74 68 | 65 20 53 79 73 74 65 6d | from th|e System|
|00000da0| 20 66 69 6c 65 2e 20 20 | 54 68 69 73 20 73 6f 75 | file. |This sou|
|00000db0| 6e 64 20 63 6f 6e 74 61 | 69 6e 73 20 6d 61 6e 79 |nd conta|ins many|
|00000dc0| 20 61 6d 70 43 6d 64 73 | 2e 20 20 49 66 20 79 6f | ampCmds|. If yo|
|00000dd0| 75 20 6e 6f 74 69 63 65 | 2c 20 74 68 69 73 20 d4 |u notice|, this .|
|00000de0| 73 6e 64 20 d4 20 72 65 | 73 6f 75 72 63 65 20 6e |snd . re|source n|
|00000df0| 65 76 65 72 20 70 6c 61 | 79 73 20 69 66 20 73 65 |ever pla|ys if se|
|00000e00| 6c 65 63 74 65 64 20 6f | 6e 20 d2 63 6c 61 73 73 |lected o|n .class|
|00000e10| 69 63 d3 20 68 61 72 64 | 77 61 72 65 20 69 6e 20 |ic. hard|ware in |
|00000e20| 74 68 65 20 53 6f 75 6e | 64 20 63 6f 6e 74 72 6f |the Soun|d contro|
|00000e30| 6c 20 70 61 6e 65 6c 2e | 20 20 49 6e 73 74 65 61 |l panel.| Instea|
|00000e40| 64 2c 20 53 79 73 42 65 | 65 70 20 77 61 73 20 70 |d, SysBe|ep was p|
|00000e50| 61 74 63 68 65 64 20 74 | 6f 20 63 68 65 63 6b 20 |atched t|o check |
|00000e60| 66 6f 72 20 74 68 69 73 | 20 72 65 73 6f 75 72 63 |for this| resourc|
|00000e70| 65 20 49 44 20 61 6e 64 | 20 77 69 6c 6c 20 63 61 |e ID and| will ca|
|00000e80| 6c 6c 20 74 68 65 20 6f | 72 69 67 69 6e 61 6c 20 |ll the o|riginal |
|00000e90| 52 4f 4d 20 63 6f 64 65 | 20 74 6f 20 70 6c 61 79 |ROM code| to play|
|00000ea0| 20 61 20 74 6f 6e 65 2e | 20 20 54 68 69 73 20 77 | a tone.| This w|
|00000eb0| 61 73 20 64 6f 6e 65 20 | 62 65 63 61 75 73 65 20 |as done |because |
|00000ec0| 77 68 65 6e 20 53 79 73 | 74 65 6d 20 36 2e 30 20 |when Sys|tem 6.0 |
|00000ed0| 77 61 73 20 73 68 69 70 | 70 65 64 20 28 77 68 69 |was ship|ped (whi|
|00000ee0| 63 68 20 63 6f 6e 74 61 | 69 6e 65 64 20 74 68 65 |ch conta|ined the|
|00000ef0| 20 66 69 72 73 74 20 76 | 65 72 73 69 6f 6e 20 6f | first v|ersion o|
|00000f00| 66 20 74 68 65 20 53 6f | 75 6e 64 20 4d 61 6e 61 |f the So|und Mana|
|00000f10| 67 65 72 20 74 68 61 74 | 20 73 75 70 70 6f 72 74 |ger that| support|
|00000f20| 65 64 20 74 68 65 20 63 | 6c 61 73 73 69 63 20 68 |ed the c|lassic h|
|00000f30| 61 72 64 77 61 72 65 29 | 20 69 73 20 77 61 73 20 |ardware)| is was |
|00000f40| 76 65 72 79 20 6e 6f 69 | 73 65 79 2e 20 20 41 73 |very noi|sey. As|
|00000f50| 20 61 20 72 65 73 75 6c | 74 20 28 62 75 74 20 6d | a resul|t (but m|
|00000f60| 6f 73 74 6c 79 20 64 75 | 65 20 74 6f 20 74 68 65 |ostly du|e to the|
|00000f70| 20 53 6f 75 6e 64 20 4d | 61 6e 61 67 65 72 d5 73 | Sound M|anager.s|
|00000f80| 20 64 69 72 65 63 74 20 | 75 73 65 20 6f 66 20 74 | direct |use of t|
|00000f90| 68 65 20 56 49 41 20 54 | 69 6d 65 72 29 20 74 68 |he VIA T|imer) th|
|00000fa0| 65 20 53 79 73 74 65 6d | 20 77 61 73 20 63 68 61 |e System| was cha|
|00000fb0| 6e 67 65 64 20 74 6f 20 | 73 70 65 63 69 61 6c 20 |nged to |special |
|00000fc0| 63 61 73 65 20 74 68 69 | 73 20 73 6f 75 6e 64 20 |case thi|s sound |
|00000fd0| 74 6f 20 61 76 6f 69 64 | 20 70 6c 61 79 69 6e 67 |to avoid| playing|
|00000fe0| 20 53 69 6d 70 6c 65 20 | 42 65 65 70 2e 0d 53 79 | Simple |Beep..Sy|
|00000ff0| 73 74 65 6d 20 36 2e 30 | 2e 37 2d 62 65 79 6f 6e |stem 6.0|.7-beyon|
|00001000| 64 0d 49 74 20 68 6f 6e | 65 73 74 6c 79 20 63 68 |d.It hon|estly ch|
|00001010| 61 6e 67 65 73 20 74 68 | 65 20 76 6f 6c 75 6d 65 |anges th|e volume|
|00001020| 20 6f 66 20 61 20 73 61 | 6d 70 6c 65 64 20 73 6f | of a sa|mpled so|
|00001030| 75 6e 64 2e 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |und..___|________|
|00001040| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001050| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 61 76 61 69 6c 61 |________|_.availa|
|00001060| 62 6c 65 43 6d 64 0d 70 | 61 72 61 6d 31 09 30 20 |bleCmd.p|aram1.0 |
|00001070| 6f 6e 20 69 6e 70 75 74 | 20 72 65 73 75 6c 74 20 |on input| result |
|00001080| 6f 66 20 63 6f 6d 6d 61 | 6e 64 20 6f 6e 20 6f 75 |of comma|nd on ou|
|00001090| 74 70 75 74 0d 70 61 72 | 61 6d 32 09 69 6e 69 74 |tput.par|am2.init|
|000010a0| 69 61 6c 69 7a 61 74 69 | 6f 6e 20 70 61 72 61 6d |ializati|on param|
|000010b0| 65 74 65 72 73 0d 44 65 | 74 65 72 6d 69 6e 65 73 |eters.De|termines|
|000010c0| 20 69 66 20 74 68 65 20 | 69 6e 69 74 69 61 6c 69 | if the |initiali|
|000010d0| 7a 61 74 69 6f 6e 20 70 | 61 72 61 6d 65 74 65 72 |zation p|arameter|
|000010e0| 73 20 70 61 73 73 65 64 | 20 69 6e 20 70 61 72 61 |s passed| in para|
|000010f0| 6d 32 20 61 72 65 20 73 | 75 70 70 6f 72 74 65 64 |m2 are s|upported|
|00001100| 20 62 79 20 74 68 65 20 | 73 79 6e 74 68 65 73 69 | by the |synthesi|
|00001110| 7a 65 72 20 74 6f 20 77 | 68 69 63 68 20 74 68 69 |zer to w|hich thi|
|00001120| 73 20 63 6f 6d 6d 61 6e | 64 20 69 73 20 73 65 6e |s comman|d is sen|
|00001130| 74 2e 20 54 68 65 20 72 | 65 73 75 6c 74 20 69 73 |t. The r|esult is|
|00001140| 20 72 65 74 75 72 6e 65 | 64 20 69 6e 20 70 61 72 | returne|d in par|
|00001150| 61 6d 31 20 74 68 65 20 | 72 65 73 75 6c 74 20 69 |am1 the |result i|
|00001160| 73 20 31 20 69 66 20 74 | 68 65 20 73 79 6e 74 68 |s 1 if t|he synth|
|00001170| 65 73 69 7a 65 72 20 73 | 75 70 70 6f 72 74 73 20 |esizer s|upports |
|00001180| 74 68 65 20 64 65 73 69 | 72 65 64 20 63 68 61 72 |the desi|red char|
|00001190| 61 63 74 65 72 69 73 74 | 69 63 73 20 61 6e 64 20 |acterist|ics and |
|000011a0| 30 20 69 66 20 69 74 20 | 64 6f 65 73 20 6e 6f 74 |0 if it |does not|
|000011b0| 2e 20 59 6f 75 20 63 61 | 6e 20 73 65 6e 64 20 61 |. You ca|n send a|
|000011c0| 76 61 69 6c 61 62 6c 65 | 43 6d 64 20 74 6f 20 61 |vailable|Cmd to a|
|000011d0| 6e 79 20 6f 66 20 74 68 | 65 20 61 76 61 69 6c 61 |ny of th|e availa|
|000011e0| 62 6c 65 20 73 79 6e 74 | 68 65 73 69 7a 65 72 73 |ble synt|hesizers|
|000011f0| 2c 20 62 75 74 20 79 6f | 75 20 6d 75 73 74 20 73 |, but yo|u must s|
|00001200| 65 6e 64 20 69 74 20 62 | 79 20 75 73 69 6e 67 20 |end it b|y using |
|00001210| 53 6e 64 43 6f 6e 74 72 | 6f 6c 2e 0d 53 6f 75 6e |SndContr|ol..Soun|
|00001220| 64 20 4d 61 6e 61 67 65 | 72 20 70 72 65 2d 36 2e |d Manage|r pre-6.|
|00001230| 30 2e 37 0d 54 68 65 20 | 61 76 61 69 6c 61 62 6c |0.7.The |availabl|
|00001240| 65 43 6d 64 20 69 73 20 | 72 65 74 75 72 6e 69 6e |eCmd is |returnin|
|00001250| 67 20 61 20 76 61 6c 75 | 65 20 6f 66 20 31 2c 20 |g a valu|e of 1, |
|00001260| 6d 65 61 6e 69 6e 67 20 | 54 52 55 45 2c 20 65 76 |meaning |TRUE, ev|
|00001270| 65 6e 20 69 66 20 74 68 | 65 20 73 79 6e 74 68 65 |en if th|e synthe|
|00001280| 73 69 7a 65 72 20 69 73 | 20 61 63 74 75 61 6c 6c |sizer is| actuall|
|00001290| 79 20 6e 6f 20 6c 6f 6e | 67 65 72 20 61 76 61 69 |y no lon|ger avai|
|000012a0| 6c 61 62 6c 65 2e 20 20 | 46 6f 72 20 65 78 61 6d |lable. |For exam|
|000012b0| 70 6c 65 2c 20 61 66 74 | 65 72 20 63 61 6c 6c 69 |ple, aft|er calli|
|000012c0| 6e 67 20 53 6e 64 4e 65 | 77 43 68 61 6e 6e 65 6c |ng SndNe|wChannel|
|000012d0| 20 66 6f 72 20 74 68 65 | 20 6e 6f 74 65 53 79 6e | for the| noteSyn|
|000012e0| 74 68 2c 20 74 68 65 20 | 61 76 61 69 6c 61 62 6c |th, the |availabl|
|000012f0| 65 43 6d 64 20 66 6f 72 | 20 74 68 65 20 6e 6f 74 |eCmd for| the not|
|00001300| 65 53 79 6e 74 68 20 73 | 68 6f 75 6c 64 20 72 65 |eSynth s|hould re|
|00001310| 74 75 72 6e 20 46 41 4c | 53 45 20 73 69 6e 63 65 |turn FAL|SE since|
|00001320| 20 74 68 65 72 65 20 69 | 73 6e d5 74 20 61 20 73 | there i|sn.t a s|
|00001330| 65 63 6f 6e 64 20 6f 6e | 65 2e 20 20 46 75 72 74 |econd on|e. Furt|
|00001340| 68 65 72 6d 6f 72 65 2c | 20 63 6f 6e 73 69 64 65 |hermore,| conside|
|00001350| 72 69 6e 67 20 74 68 61 | 74 20 6f 6e 6c 79 20 6f |ring tha|t only o|
|00001360| 6e 65 20 73 79 6e 74 68 | 65 73 69 7a 65 72 20 63 |ne synth|esizer c|
|00001370| 61 6e 20 62 65 20 61 63 | 74 69 76 65 20 61 74 20 |an be ac|tive at |
|00001380| 6f 6e 65 20 74 69 6d 65 | 2c 20 61 66 74 65 72 20 |one time|, after |
|00001390| 6f 70 65 6e 69 6e 67 20 | 74 68 65 20 6e 6f 74 65 |opening |the note|
|000013a0| 53 79 6e 74 68 20 74 68 | 65 20 73 61 6d 70 6c 65 |Synth th|e sample|
|000013b0| 64 53 79 6e 74 68 20 69 | 73 20 6e 6f 74 20 61 76 |dSynth i|s not av|
|000013c0| 61 69 6c 61 62 6c 65 2c | 20 62 75 74 20 74 68 69 |ailable,| but thi|
|000013d0| 73 20 63 6f 6d 6d 61 6e | 64 20 72 65 70 6f 72 74 |s comman|d report|
|000013e0| 73 20 74 68 61 74 20 69 | 74 20 69 73 2e 20 20 54 |s that i|t is. T|
|000013f0| 68 65 20 6f 6e 6c 79 20 | 74 69 6d 65 20 74 68 65 |he only |time the|
|00001400| 20 61 76 61 69 6c 61 62 | 6c 65 43 6d 64 20 77 69 | availab|leCmd wi|
|00001410| 6c 6c 20 72 65 74 75 72 | 6e 20 46 41 4c 53 45 20 |ll retur|n FALSE |
|00001420| 69 73 20 62 79 20 72 65 | 71 75 65 73 74 69 6e 67 |is by re|questing|
|00001430| 20 61 6e 20 69 6e 69 74 | 20 6f 70 74 69 6f 6e 20 | an init| option |
|00001440| 74 68 61 74 20 61 20 73 | 79 6e 74 68 65 73 69 7a |that a s|ynthesiz|
|00001450| 65 72 20 64 6f 65 73 6e | d5 74 20 73 75 70 70 6f |er doesn|.t suppo|
|00001460| 72 74 2c 20 73 75 63 68 | 20 61 73 20 73 74 65 72 |rt, such| as ster|
|00001470| 65 6f 20 63 68 61 6e 6e | 65 6c 73 2e 0d 53 79 73 |eo chann|els..Sys|
|00001480| 74 65 6d 20 20 36 2e 30 | 2e 37 2d 37 2e 30 2e 31 |tem 6.0|.7-7.0.1|
|00001490| 0d 54 68 65 20 73 61 6d | 70 6c 65 64 20 73 6f 75 |.The sam|pled sou|
|000014a0| 6e 64 20 73 79 6e 74 68 | 65 73 69 7a 65 72 20 69 |nd synth|esizer i|
|000014b0| 73 20 74 65 73 74 69 6e | 67 20 69 66 20 74 68 65 |s testin|g if the|
|000014c0| 20 69 6e 69 74 69 61 6c | 69 7a 61 74 69 6f 6e 20 | initial|ization |
|000014d0| 70 61 72 61 6d 65 74 65 | 72 73 20 70 61 73 73 65 |paramete|rs passe|
|000014e0| 64 20 69 6e 20 70 61 72 | 61 6d 32 20 69 73 20 61 |d in par|am2 is a|
|000014f0| 76 61 69 6c 61 62 6c 65 | 20 62 79 20 63 6f 6e 73 |vailable| by cons|
|00001500| 69 64 65 72 69 6e 67 20 | 74 68 65 20 43 50 55 20 |idering |the CPU |
|00001510| 6c 6f 61 64 69 6e 67 20 | 66 61 63 74 6f 72 2e 20 |loading |factor. |
|00001520| 20 49 66 20 6e 6f 20 63 | 68 61 6e 6e 65 6c 20 69 | If no c|hannel i|
|00001530| 73 20 61 6c 6c 6f 63 61 | 74 65 64 20 74 68 65 20 |s alloca|ted the |
|00001540| 72 65 73 75 6c 74 20 77 | 69 6c 6c 20 62 65 20 64 |result w|ill be d|
|00001550| 69 66 66 65 72 65 6e 74 | 20 74 68 61 6e 20 69 66 |ifferent| than if|
|00001560| 20 6d 61 6e 79 20 63 68 | 61 6e 6e 65 6c 73 20 61 | many ch|annels a|
|00001570| 72 65 20 69 6e 20 70 6c | 61 79 69 6e 67 20 62 65 |re in pl|aying be|
|00001580| 63 61 75 73 65 20 69 74 | 20 61 6c 6c 20 64 65 70 |cause it| all dep|
|00001590| 65 6e 64 73 20 6f 6e 20 | 74 68 65 20 43 50 55 20 |ends on |the CPU |
|000015a0| 6c 6f 61 64 69 6e 67 2e | 20 20 54 68 65 20 63 6f |loading.| The co|
|000015b0| 6d 6d 61 6e 64 20 77 61 | 73 20 64 65 73 69 67 6e |mmand wa|s design|
|000015c0| 65 64 20 74 6f 20 74 65 | 6c 6c 20 79 6f 75 20 69 |ed to te|ll you i|
|000015d0| 66 20 74 68 65 20 73 79 | 6e 74 68 65 73 69 7a 65 |f the sy|nthesize|
|000015e0| 72 20 64 6f 65 73 20 69 | 6e 20 66 61 63 74 20 73 |r does i|n fact s|
|000015f0| 75 70 70 6f 72 74 20 61 | 6e 20 6f 70 74 69 6f 6e |upport a|n option|
|00001600| 20 28 69 2e 65 2e 20 73 | 74 65 72 65 6f 2c 20 62 | (i.e. s|tereo, b|
|00001610| 75 74 20 79 6f 75 20 73 | 68 6f 75 6c 64 20 75 73 |ut you s|hould us|
|00001620| 65 20 47 65 73 74 61 6c | 74 20 66 6f 72 20 74 68 |e Gestal|t for th|
|00001630| 69 73 29 2e 20 20 42 65 | 63 61 75 73 65 20 6f 66 |is). Be|cause of|
|00001640| 20 74 68 69 73 20 d2 66 | 65 61 74 75 72 65 d3 20 | this .f|eature. |
|00001650| 79 6f 75 20 63 61 6e 6e | 6f 74 20 72 65 6c 79 20 |you cann|ot rely |
|00001660| 75 70 6f 6e 20 74 68 65 | 20 72 65 73 75 6c 74 73 |upon the| results|
|00001670| 20 6f 66 20 74 68 65 20 | 61 76 61 69 6c 61 62 6c | of the |availabl|
|00001680| 65 43 6d 64 2e 0d 49 74 | 20 69 73 20 6e 6f 74 20 |eCmd..It| is not |
|00001690| 70 6f 73 73 69 62 6c 65 | 20 74 6f 20 64 65 74 65 |possible| to dete|
|000016a0| 72 6d 69 6e 65 20 77 68 | 65 6e 20 6d 6f 72 65 20 |rmine wh|en more |
|000016b0| 74 68 61 6e 20 74 68 65 | 20 6d 61 78 69 6d 75 6d |than the| maximum|
|000016c0| 20 6e 75 6d 62 65 72 20 | 6f 66 20 77 61 76 65 20 | number |of wave |
|000016d0| 74 61 62 6c 65 20 63 68 | 61 6e 6e 65 6c 73 20 68 |table ch|annels h|
|000016e0| 61 73 20 62 65 65 6e 20 | 61 6c 6c 6f 63 61 74 65 |as been |allocate|
|000016f0| 64 2e 20 20 49 74 20 69 | 73 20 6e 6f 74 20 70 6f |d. It i|s not po|
|00001700| 73 73 69 62 6c 65 20 74 | 6f 20 64 65 74 65 72 6d |ssible t|o determ|
|00001710| 69 6e 65 20 69 66 20 61 | 20 73 79 6e 74 68 65 73 |ine if a| synthes|
|00001720| 69 7a 65 72 20 69 73 20 | 69 6e 20 75 73 65 20 62 |izer is |in use b|
|00001730| 79 20 61 6e 6f 74 68 65 | 72 20 61 70 70 6c 69 63 |y anothe|r applic|
|00001740| 61 74 69 6f 6e 2e 20 20 | 49 66 20 61 6c 6c 20 61 |ation. |If all a|
|00001750| 70 70 6c 69 63 61 74 69 | 6f 6e 73 20 77 6f 75 6c |pplicati|ons woul|
|00001760| 64 20 64 69 73 70 6f 73 | 65 20 6f 66 20 74 68 65 |d dispos|e of the|
|00001770| 69 72 20 63 68 61 6e 6e | 65 6c 73 20 61 74 20 74 |ir chann|els at t|
|00001780| 68 65 20 72 65 73 75 6d | 65 20 65 76 65 6e 74 2c |he resum|e event,|
|00001790| 20 74 68 69 73 20 77 6f | 75 6c 64 20 6e 6f 74 20 | this wo|uld not |
|000017a0| 62 65 20 61 20 70 72 6f | 62 6c 65 6d 2e 0d 5f 5f |be a pro|blem..__|
|000017b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000017c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000017d0| 5f 5f 0d 62 75 66 66 65 | 72 43 6d 64 0d 70 61 72 |__.buffe|rCmd.par|
|000017e0| 61 6d 31 09 30 20 28 69 | 67 6e 6f 72 65 64 20 6f |am1.0 (i|gnored o|
|000017f0| 6e 20 69 6e 70 75 74 20 | 61 6e 64 20 6f 75 74 70 |n input |and outp|
|00001800| 75 74 29 0d 70 61 72 61 | 6d 32 09 6f 66 66 73 65 |ut).para|m2.offse|
|00001810| 74 20 6f 72 20 70 6f 69 | 6e 74 65 72 20 74 6f 20 |t or poi|nter to |
|00001820| 73 6f 75 6e 64 20 64 61 | 74 61 0d 50 6c 61 79 73 |sound da|ta.Plays|
|00001830| 20 61 20 62 75 66 66 65 | 72 20 6f 66 20 73 61 6d | a buffe|r of sam|
|00001840| 70 6c 65 64 20 73 6f 75 | 6e 64 20 64 61 74 61 2e |pled sou|nd data.|
|00001850| 20 49 66 20 74 68 65 20 | 68 69 67 68 20 62 69 74 | If the |high bit|
|00001860| 20 6f 66 20 74 68 65 20 | 63 6f 6d 6d 61 6e 64 20 | of the |command |
|00001870| 69 73 20 73 65 74 2c 20 | 70 61 72 61 6d 32 20 69 |is set, |param2 i|
|00001880| 73 20 69 6e 74 65 72 70 | 72 65 74 65 64 20 61 73 |s interp|reted as|
|00001890| 20 61 6e 20 6f 66 66 73 | 65 74 20 66 72 6f 6d 20 | an offs|et from |
|000018a0| 74 68 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 6f 66 |the begi|nning of|
|000018b0| 20 74 68 65 20 d4 73 6e | 64 20 d4 20 72 65 73 6f | the .sn|d . reso|
|000018c0| 75 72 63 65 20 63 6f 6e | 74 61 69 6e 69 6e 67 20 |urce con|taining |
|000018d0| 74 68 65 20 63 6f 6d 6d | 61 6e 64 20 74 6f 20 74 |the comm|and to t|
|000018e0| 68 65 20 73 6f 75 6e 64 | 20 64 61 74 61 2e 20 49 |he sound| data. I|
|000018f0| 66 20 74 68 65 20 68 69 | 67 68 20 62 69 74 20 69 |f the hi|gh bit i|
|00001900| 73 20 6e 6f 74 20 73 65 | 74 2c 20 70 61 72 61 6d |s not se|t, param|
|00001910| 32 20 69 73 20 69 6e 74 | 65 72 70 72 65 74 65 64 |2 is int|erpreted|
|00001920| 20 61 73 20 61 20 70 6f | 69 6e 74 65 72 20 74 6f | as a po|inter to|
|00001930| 20 61 20 73 61 6d 70 6c | 65 64 20 73 6f 75 6e 64 | a sampl|ed sound|
|00001940| 20 68 65 61 64 65 72 20 | 6c 6f 63 6b 65 64 20 69 | header |locked i|
|00001950| 6e 20 6d 65 6d 6f 72 79 | 2e 20 59 6f 75 20 63 61 |n memory|. You ca|
|00001960| 6e 20 73 65 6e 64 20 62 | 75 66 66 65 72 43 6d 64 |n send b|ufferCmd|
|00001970| 20 6f 6e 6c 79 20 74 6f | 20 74 68 65 20 73 61 6d | only to| the sam|
|00001980| 70 6c 65 64 20 73 6f 75 | 6e 64 20 73 79 6e 74 68 |pled sou|nd synth|
|00001990| 65 73 69 7a 65 72 2e 20 | 20 54 68 69 73 20 63 6f |esizer. | This co|
|000019a0| 6d 6d 61 6e 64 20 77 69 | 6c 6c 20 72 65 73 65 74 |mmand wi|ll reset|
|000019b0| 20 74 68 65 20 63 68 61 | 6e 6e 65 6c d5 73 20 72 | the cha|nnel.s r|
|000019c0| 61 74 65 20 74 6f 20 61 | 20 72 61 74 65 20 6f 66 |ate to a| rate of|
|000019d0| 20 31 2e 30 2c 20 77 68 | 69 63 68 20 6d 61 79 20 | 1.0, wh|ich may |
|000019e0| 68 61 76 65 20 62 65 65 | 6e 20 70 72 65 76 69 6f |have bee|n previo|
|000019f0| 75 73 6c 79 20 73 65 74 | 20 62 79 20 61 20 72 61 |usly set| by a ra|
|00001a00| 74 65 43 6d 64 2e 0d 53 | 6e 64 44 6f 49 6d 6d 65 |teCmd..S|ndDoImme|
|00001a10| 64 69 61 74 65 0d 54 68 | 69 73 20 73 68 6f 75 6c |diate.Th|is shoul|
|00001a20| 64 20 6f 76 65 72 72 69 | 64 65 20 61 6e 79 20 63 |d overri|de any c|
|00001a30| 75 72 72 65 6e 74 20 63 | 6f 6d 6d 61 6e 64 20 69 |urrent c|ommand i|
|00001a40| 6e 20 70 72 6f 67 72 65 | 73 73 2e 20 20 46 6f 72 |n progre|ss. For|
|00001a50| 20 65 78 61 6d 70 6c 65 | 2c 20 69 66 20 61 20 63 | example|, if a c|
|00001a60| 68 61 6e 6e 65 6c 20 69 | 73 20 77 61 69 74 69 6e |hannel i|s waitin|
|00001a70| 67 20 66 6f 72 20 74 68 | 65 20 64 75 72 61 74 69 |g for th|e durati|
|00001a80| 6f 6e 20 6f 66 20 61 20 | 72 65 73 74 43 6d 64 2c |on of a |restCmd,|
|00001a90| 20 77 61 69 74 43 6d 64 | 2c 20 6f 72 20 66 72 65 | waitCmd|, or fre|
|00001aa0| 71 44 75 72 61 74 69 6f | 6e 43 6d 64 20 74 68 65 |qDuratio|nCmd the|
|00001ab0| 6e 20 74 68 61 74 20 63 | 6f 6d 6d 61 6e 64 20 69 |n that c|ommand i|
|00001ac0| 73 20 74 65 72 6d 69 6e | 61 74 65 64 20 61 6e 64 |s termin|ated and|
|00001ad0| 20 74 68 65 20 6e 65 77 | 20 62 75 66 66 65 72 20 | the new| buffer |
|00001ae0| 69 73 20 70 6c 61 79 65 | 64 2e 0d 53 79 73 74 65 |is playe|d..Syste|
|00001af0| 6d 20 20 36 2e 30 2e 37 | 2d 37 2e 30 2e 31 0d 49 |m 6.0.7|-7.0.1.I|
|00001b00| 66 20 61 20 73 6f 75 6e | 64 20 69 73 20 69 6e 20 |f a soun|d is in |
|00001b10| 70 72 6f 67 72 65 73 73 | 2c 20 74 68 65 6e 20 74 |progress|, then t|
|00001b20| 68 65 20 62 75 66 66 65 | 72 43 6d 64 20 77 69 6c |he buffe|rCmd wil|
|00001b30| 6c 20 62 65 20 69 67 6e | 6f 72 65 64 2e 20 20 54 |l be ign|ored. T|
|00001b40| 68 69 73 20 77 61 73 20 | 64 6f 6e 65 20 62 65 63 |his was |done bec|
|00001b50| 61 75 73 65 20 6f 66 20 | 64 69 66 66 69 63 75 6c |ause of |difficul|
|00001b60| 74 69 65 73 20 69 6e 76 | 6f 6c 76 65 64 20 77 69 |ties inv|olved wi|
|00001b70| 74 68 20 74 72 79 69 6e | 67 20 74 6f 20 73 74 6f |th tryin|g to sto|
|00001b80| 70 20 61 20 73 6f 75 6e | 64 20 61 6e 64 20 67 65 |p a soun|d and ge|
|00001b90| 74 20 61 20 6e 65 77 20 | 6f 6e 65 20 73 74 61 72 |t a new |one star|
|00001ba0| 74 65 64 2e 20 20 45 76 | 65 6e 20 69 66 20 79 6f |ted. Ev|en if yo|
|00001bb0| 75 20 73 65 6e 64 20 61 | 20 71 75 69 65 74 43 6d |u send a| quietCm|
|00001bc0| 64 20 61 6e 64 20 62 75 | 66 66 65 72 43 6d 64 20 |d and bu|fferCmd |
|00001bd0| 75 73 69 6e 67 20 53 6e | 64 44 6f 49 6d 6d 65 64 |using Sn|dDoImmed|
|00001be0| 69 61 74 65 20 69 74 20 | 6d 61 79 20 73 74 69 6c |iate it |may stil|
|00001bf0| 6c 20 69 67 6e 6f 72 65 | 20 74 68 65 20 6e 65 77 |l ignore| the new|
|00001c00| 20 62 75 66 66 65 72 43 | 6d 64 2e 20 20 54 68 65 | bufferC|md. The|
|00001c10| 20 63 68 61 6e 6e 65 6c | d5 73 20 62 75 73 79 20 | channel|.s busy |
|00001c20| 66 6c 61 67 20 68 61 73 | 20 74 6f 20 62 65 20 63 |flag has| to be c|
|00001c30| 6c 65 61 72 65 64 20 62 | 65 66 6f 72 65 20 69 74 |leared b|efore it|
|00001c40| 20 77 69 6c 6c 20 61 6c | 6c 6f 77 20 61 20 6e 65 | will al|low a ne|
|00001c50| 77 20 62 75 66 66 65 72 | 20 74 6f 20 62 65 20 70 |w buffer| to be p|
|00001c60| 6c 61 79 65 64 2e 0d 48 | 79 70 65 72 63 61 72 64 |layed..H|ypercard|
|00001c70| 20 d2 53 65 63 72 65 74 | 20 50 61 73 73 77 6f 72 | .Secret| Passwor|
|00001c80| 64 d3 20 0d 49 66 20 70 | 61 72 61 6d 31 20 70 61 |d. .If p|aram1 pa|
|00001c90| 73 73 65 64 20 74 6f 20 | 74 68 65 20 62 75 66 66 |ssed to |the buff|
|00001ca0| 65 72 20 63 6f 6d 6d 61 | 6e 64 20 63 6f 6e 74 61 |er comma|nd conta|
|00001cb0| 69 6e 73 20 74 68 65 20 | 76 61 6c 75 65 20 2d 33 |ins the |value -3|
|00001cc0| 31 34 31 2c 20 74 68 65 | 6e 20 74 68 65 20 62 61 |141, the|n the ba|
|00001cd0| 73 65 46 72 65 71 75 65 | 6e 63 79 76 61 6c 75 65 |seFreque|ncyvalue|
|00001ce0| 20 69 6e 20 74 68 65 20 | 73 6f 75 6e 64 20 68 65 | in the |sound he|
|00001cf0| 61 64 65 72 20 69 73 20 | 75 73 65 64 20 74 6f 20 |ader is |used to |
|00001d00| 6f 66 66 73 65 74 20 74 | 68 65 20 70 6c 61 79 62 |offset t|he playb|
|00001d10| 61 63 6b 20 72 61 74 65 | 20 66 72 6f 6d 20 6d 69 |ack rate| from mi|
|00001d20| 64 64 6c 65 20 43 2e 20 | 4f 74 68 65 72 77 69 73 |ddle C. |Otherwis|
|00001d30| 65 20 6f 6e 6c 79 20 74 | 68 65 20 73 61 6d 70 6c |e only t|he sampl|
|00001d40| 65 20 72 61 74 65 20 69 | 6e 20 74 68 65 20 73 6f |e rate i|n the so|
|00001d50| 75 6e 64 20 68 65 61 64 | 65 72 20 64 65 74 65 72 |und head|er deter|
|00001d60| 6d 69 6e 65 73 20 74 68 | 65 20 70 6c 61 79 62 61 |mines th|e playba|
|00001d70| 63 6b 20 72 61 74 65 2e | 20 20 54 68 69 73 20 69 |ck rate.| This i|
|00001d80| 73 20 75 73 65 64 20 69 | 6e 20 74 68 65 20 50 4c |s used i|n the PL|
|00001d90| 41 59 20 63 6f 6d 6d 61 | 6e 64 20 6f 66 20 48 79 |AY comma|nd of Hy|
|00001da0| 65 72 43 61 72 64 2e 20 | 20 49 66 20 74 68 65 20 |erCard. | If the |
|00001db0| 62 61 73 65 46 72 65 71 | 75 65 6e 63 79 20 69 73 |baseFreq|uency is|
|00001dc0| 20 73 6f 6d 65 74 68 69 | 6e 67 20 6f 74 68 65 72 | somethi|ng other|
|00001dd0| 20 74 68 61 6e 20 74 68 | 65 20 76 61 6c 75 65 20 | than th|e value |
|00001de0| 6f 66 20 36 30 2c 20 74 | 68 65 20 73 6f 75 6e 64 |of 60, t|he sound|
|00001df0| 20 77 69 6c 6c 20 6e 6f | 74 20 70 6c 61 79 20 61 | will no|t play a|
|00001e00| 63 63 6f 72 64 69 6e 67 | 20 74 6f 20 69 74 73 20 |ccording| to its |
|00001e10| 73 6f 75 6e 64 20 68 65 | 61 64 65 72 2e 20 20 54 |sound he|ader. T|
|00001e20| 68 69 73 20 68 61 73 20 | 63 6f 6e 66 75 73 65 64 |his has |confused|
|00001e30| 20 6d 61 6e 79 20 64 65 | 76 65 6c 6f 70 65 72 73 | many de|velopers|
|00001e40| 20 74 72 79 69 6e 67 20 | 74 6f 20 70 6c 61 79 20 | trying |to play |
|00001e50| 73 6f 75 6e 64 73 20 74 | 68 65 79 20 63 6f 70 69 |sounds t|hey copi|
|00001e60| 65 64 20 66 72 6f 6d 20 | 48 79 70 65 72 43 61 72 |ed from |HyperCar|
|00001e70| 64 20 73 74 61 63 6b 73 | 20 62 75 74 20 75 73 69 |d stacks| but usi|
|00001e80| 6e 67 20 74 68 65 69 72 | 20 6f 77 6e 20 53 6f 75 |ng their| own Sou|
|00001e90| 6e 64 20 4d 61 6e 61 67 | 65 72 20 63 6f 64 65 2e |nd Manag|er code.|
|00001ea0| 20 20 57 65 20 63 6f 75 | 6c 64 20 6e 6f 74 20 72 | We cou|ld not r|
|00001eb0| 65 6d 6f 76 65 20 74 68 | 69 73 20 68 61 63 6b 20 |emove th|is hack |
|00001ec0| 66 72 6f 6d 20 74 68 65 | 20 6e 65 77 20 53 6f 75 |from the| new Sou|
|00001ed0| 6e 64 20 4d 61 6e 61 67 | 65 72 20 62 65 63 61 75 |nd Manag|er becau|
|00001ee0| 73 65 20 48 79 70 65 72 | 43 61 72 64 20 77 61 73 |se Hyper|Card was|
|00001ef0| 20 72 65 6c 79 69 6e 67 | 20 75 70 6f 6e 20 74 68 | relying| upon th|
|00001f00| 69 73 20 62 65 68 61 76 | 69 6f 75 72 2e 20 20 49 |is behav|iour. I|
|00001f10| 74 20 77 6f 75 6c 64 20 | 62 65 20 65 61 73 79 20 |t would |be easy |
|00001f20| 74 6f 20 72 65 70 72 6f | 64 75 63 65 20 74 68 69 |to repro|duce thi|
|00001f30| 73 20 61 66 66 65 63 74 | 20 77 69 74 68 6f 75 74 |s affect| without|
|00001f40| 20 74 68 65 20 73 65 63 | 72 65 74 20 70 61 73 73 | the sec|ret pass|
|00001f50| 77 6f 72 64 2c 20 61 6e | 64 20 69 6e 20 66 61 63 |word, an|d in fac|
|00001f60| 74 20 53 6f 75 6e 64 41 | 70 70 20 28 44 54 53 20 |t SoundA|pp (DTS |
|00001f70| 73 61 6d 70 6c 65 20 63 | 6f 64 65 29 20 64 65 6d |sample c|ode) dem|
|00001f80| 6f 6e 73 74 72 61 74 65 | 73 20 61 6c 6c 20 6f 66 |onstrate|s all of|
|00001f90| 20 74 68 65 20 6e 65 63 | 65 73 73 61 72 79 20 63 | the nec|essary c|
|00001fa0| 6f 64 65 2e 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ode..___|________|
|00001fb0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001fc0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 63 61 6c 6c 42 61 |________|_.callBa|
|00001fd0| 63 6b 43 6d 64 0d 70 61 | 72 61 6d 31 09 61 70 70 |ckCmd.pa|ram1.app|
|00001fe0| 6c 69 63 61 74 69 6f 6e | 2d 64 65 66 69 6e 65 64 |lication|-defined|
|00001ff0| 0d 70 61 72 61 6d 32 09 | 61 70 70 6c 69 63 61 74 |.param2.|applicat|
|00002000| 69 6f 6e 2d 64 65 66 69 | 6e 65 64 0d 45 78 65 63 |ion-defi|ned.Exec|
|00002010| 75 74 65 73 20 74 68 65 | 20 63 61 6c 6c 62 61 63 |utes the| callbac|
|00002020| 6b 20 70 72 6f 63 65 64 | 75 72 65 20 73 70 65 63 |k proced|ure spec|
|00002030| 69 66 69 65 64 20 61 73 | 20 61 20 70 61 72 61 6d |ified as| a param|
|00002040| 65 74 65 72 20 74 6f 20 | 53 6e 64 4e 65 77 43 68 |eter to |SndNewCh|
|00002050| 61 6e 6e 65 6c 2e 20 42 | 6f 74 68 20 70 61 72 61 |annel. B|oth para|
|00002060| 6d 31 20 61 6e 64 20 70 | 61 72 61 6d 32 20 61 72 |m1 and p|aram2 ar|
|00002070| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 73 70 |e applic|ation sp|
|00002080| 65 63 69 66 69 63 20 79 | 6f 75 20 63 61 6e 20 75 |ecific y|ou can u|
|00002090| 73 65 20 74 68 65 73 65 | 20 74 77 6f 20 70 61 72 |se these| two par|
|000020a0| 61 6d 65 74 65 72 73 20 | 74 6f 20 73 65 6e 64 20 |ameters |to send |
|000020b0| 64 61 74 61 20 74 6f 20 | 79 6f 75 72 20 63 61 6c |data to |your cal|
|000020c0| 6c 62 61 63 6b 20 72 6f | 75 74 69 6e 65 2e 20 59 |lback ro|utine. Y|
|000020d0| 6f 75 20 63 61 6e 20 73 | 65 6e 64 20 63 61 6c 6c |ou can s|end call|
|000020e0| 42 61 63 6b 43 6d 64 20 | 74 6f 20 61 6e 79 20 6f |BackCmd |to any o|
|000020f0| 66 20 74 68 65 20 61 76 | 61 69 6c 61 62 6c 65 20 |f the av|ailable |
|00002100| 73 79 6e 74 68 65 73 69 | 7a 65 72 73 2e 0d 53 79 |synthesi|zers..Sy|
|00002110| 73 74 65 6d 20 36 2e 30 | 2e 34 0d 57 68 65 6e 20 |stem 6.0|.4.When |
|00002120| 75 73 69 6e 67 20 61 20 | 66 6f 72 6d 61 74 20 32 |using a |format 2|
|00002130| 20 27 73 6e 64 20 27 20 | 77 69 74 68 20 53 6e 64 | 'snd ' |with Snd|
|00002140| 50 6c 61 79 20 61 6e 64 | 20 73 75 70 70 6c 79 69 |Play and| supplyi|
|00002150| 6e 67 20 61 20 75 73 65 | 72 20 73 6f 75 6e 64 20 |ng a use|r sound |
|00002160| 63 68 61 6e 6e 65 6c 2c | 20 74 68 65 20 53 6f 75 |channel,| the Sou|
|00002170| 6e 64 20 4d 61 6e 61 67 | 65 72 20 73 65 6e 64 73 |nd Manag|er sends|
|00002180| 20 61 20 62 6f 67 75 73 | 20 63 61 6c 6c 42 61 63 | a bogus| callBac|
|00002190| 6b 43 6d 64 20 69 6e 74 | 6f 20 74 68 65 20 71 75 |kCmd int|o the qu|
|000021a0| 65 75 65 20 69 6d 6d 65 | 64 69 61 74 65 6c 79 20 |eue imme|diately |
|000021b0| 61 66 74 65 72 20 74 68 | 65 20 62 75 66 66 65 72 |after th|e buffer|
|000021c0| 43 6d 64 20 75 73 65 64 | 20 74 6f 20 70 6c 61 79 |Cmd used| to play|
|000021d0| 20 74 68 65 20 73 6f 75 | 6e 64 2e 20 20 54 68 69 | the sou|nd. Thi|
|000021e0| 73 20 62 6f 67 75 73 20 | 63 61 6c 6c 42 61 63 6b |s bogus |callBack|
|000021f0| 43 6d 64 20 77 69 6c 6c | 20 20 63 61 75 73 65 20 |Cmd will| cause |
|00002200| 74 68 65 20 63 68 61 6e | 6e 65 6c 27 73 20 63 61 |the chan|nel's ca|
|00002210| 6c 6c 42 61 63 6b 50 72 | 6f 63 20 74 6f 20 62 65 |llBackPr|oc to be|
|00002220| 20 65 78 65 63 75 74 65 | 64 20 77 68 65 6e 20 74 | execute|d when t|
|00002230| 68 65 20 75 73 65 72 20 | 77 61 73 6e 27 74 20 65 |he user |wasn't e|
|00002240| 78 70 65 63 74 69 6e 67 | 20 69 74 2e 0d 4e 6f 74 |xpecting| it..Not|
|00002250| 65 73 0d 54 68 69 73 20 | 69 73 20 63 61 6c 6c 65 |es.This |is calle|
|00002260| 64 20 61 74 20 61 20 6c | 65 76 65 6c 20 31 20 69 |d at a l|evel 1 i|
|00002270| 6e 74 65 72 72 75 70 74 | 20 66 6f 72 20 74 68 65 |nterrupt| for the|
|00002280| 20 6e 65 77 20 53 6f 75 | 6e 64 20 4d 61 6e 61 67 | new Sou|nd Manag|
|00002290| 65 72 2c 20 64 75 65 20 | 74 6f 20 69 74 20 62 65 |er, due |to it be|
|000022a0| 69 6e 67 20 74 72 69 67 | 67 65 72 65 64 20 62 79 |ing trig|gered by|
|000022b0| 20 61 20 54 69 6d 65 20 | 4d 61 6e 61 67 65 72 20 | a Time |Manager |
|000022c0| 74 61 73 6b 2e 20 20 57 | 61 73 20 74 68 69 73 20 |task. W|as this |
|000022d0| 63 61 6c 6c 65 64 20 61 | 74 20 61 20 6c 65 76 65 |called a|t a leve|
|000022e0| 6c 20 32 20 69 6e 74 65 | 72 72 75 70 74 20 69 6e |l 2 inte|rrupt in|
|000022f0| 20 74 68 65 20 6f 6c 64 | 65 72 20 53 6f 75 6e 64 | the old|er Sound|
|00002300| 20 4d 61 6e 61 67 65 72 | 3f 0d 5f 5f 5f 5f 5f 5f | Manager|?.______|
|00002310| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002320| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 0d 63 |________|______.c|
|00002330| 6f 6e 74 69 6e 75 65 43 | 6d 64 0d 70 61 72 61 6d |ontinueC|md.param|
|00002340| 31 09 30 20 28 69 67 6e | 6f 72 65 64 20 6f 6e 20 |1.0 (ign|ored on |
|00002350| 69 6e 70 75 74 20 61 6e | 64 20 6f 75 74 70 75 74 |input an|d output|
|00002360| 29 0d 70 61 72 61 6d 32 | 09 6f 66 66 73 65 74 20 |).param2|.offset |
|00002370| 6f 72 20 70 6f 69 6e 74 | 65 72 20 74 6f 20 73 6f |or point|er to so|
|00002380| 75 6e 64 20 64 61 74 61 | 0d 54 68 69 73 20 63 6f |und data|.This co|
|00002390| 6d 6d 61 6e 64 20 69 73 | 20 73 65 6e 74 20 62 79 |mmand is| sent by|
|000023a0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 74 6f | applica|tions to|
|000023b0| 20 74 68 65 20 73 61 6d | 70 6c 65 64 20 73 6f 75 | the sam|pled sou|
|000023c0| 6e 64 20 73 79 6e 74 68 | 65 73 69 7a 65 72 2e 20 |nd synth|esizer. |
|000023d0| 20 49 74 20 69 73 20 73 | 69 6d 69 6c 61 72 20 74 | It is s|imilar t|
|000023e0| 6f 20 74 68 65 20 62 75 | 66 66 65 72 43 6d 64 2e |o the bu|fferCmd.|
|000023f0| 20 20 4c 6f 6e 67 20 73 | 61 6d 70 6c 65 64 20 73 | Long s|ampled s|
|00002400| 6f 75 6e 64 73 20 6d 61 | 79 20 62 65 20 62 72 6f |ounds ma|y be bro|
|00002410| 6b 65 6e 20 75 70 20 69 | 6e 74 6f 20 73 6d 61 6c |ken up i|nto smal|
|00002420| 6c 65 72 20 73 65 63 74 | 69 6f 6e 73 2e 20 20 49 |ler sect|ions. I|
|00002430| 6e 20 74 68 69 73 20 63 | 61 73 65 2c 20 74 68 65 |n this c|ase, the|
|00002440| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 77 6f 75 | applica|tion wou|
|00002450| 6c 64 20 75 73 65 20 74 | 68 65 20 62 75 66 66 65 |ld use t|he buffe|
|00002460| 72 43 6d 64 20 66 6f 72 | 20 74 68 65 20 66 69 72 |rCmd for| the fir|
|00002470| 73 74 20 70 6f 72 74 69 | 6f 6e 20 61 6e 64 20 74 |st porti|on and t|
|00002480| 68 65 20 63 6f 6e 74 69 | 6e 75 65 43 6d 64 20 66 |he conti|nueCmd f|
|00002490| 6f 72 20 61 6e 79 20 72 | 65 6d 61 69 6e 69 6e 67 |or any r|emaining|
|000024a0| 20 70 6f 72 74 69 6f 6e | 73 2e 20 20 54 68 69 73 | portion|s. This|
|000024b0| 20 77 69 6c 6c 20 72 65 | 73 75 6c 74 20 69 6e 20 | will re|sult in |
|000024c0| 61 20 73 69 6e 67 6c 65 | 20 63 6f 6e 74 69 6e 75 |a single| continu|
|000024d0| 6f 75 73 20 73 6f 75 6e | 64 20 77 69 74 68 20 74 |ous soun|d with t|
|000024e0| 68 65 20 66 69 72 73 74 | 20 62 79 74 65 20 6f 66 |he first| byte of|
|000024f0| 20 74 68 65 20 73 61 6d | 70 6c 65 20 62 65 69 6e | the sam|ple bein|
|00002500| 67 20 6a 6f 69 6e 65 64 | 20 77 69 74 68 20 74 68 |g joined| with th|
|00002510| 65 20 6c 61 73 74 20 62 | 79 74 65 20 6f 66 20 74 |e last b|yte of t|
|00002520| 68 65 20 70 72 65 76 69 | 6f 75 73 20 73 6f 75 6e |he previ|ous soun|
|00002530| 64 20 68 65 61 64 65 72 | 20 77 69 74 68 6f 75 74 |d header| without|
|00002540| 20 61 75 64 69 62 6c 65 | 20 63 6c 69 63 6b 73 2e | audible| clicks.|
|00002550| 0d 53 79 73 74 65 6d 20 | 73 20 70 72 65 76 69 6f |.System |s previo|
|00002560| 75 73 20 74 6f 20 36 2e | 30 2e 37 0d 54 68 69 73 |us to 6.|0.7.This|
|00002570| 20 63 6f 6d 6d 61 6e 64 | 20 68 61 73 20 6e 65 76 | command| has nev|
|00002580| 65 72 20 64 6f 6e 65 20 | 61 6e 79 74 68 69 6e 67 |er done |anything|
|00002590| 20 6f 74 68 65 72 20 74 | 68 61 6e 20 65 78 61 63 | other t|han exac|
|000025a0| 74 6c 79 20 77 68 61 74 | 20 74 68 65 20 62 75 66 |tly what| the buf|
|000025b0| 66 65 72 43 6d 64 20 64 | 69 64 2e 0d 53 79 73 74 |ferCmd d|id..Syst|
|000025c0| 65 6d 20 36 2e 30 2e 37 | 2d 62 65 79 6f 6e 64 0d |em 6.0.7|-beyond.|
|000025d0| 49 66 20 74 68 65 20 62 | 75 66 66 65 72 20 70 6f |If the b|uffer po|
|000025e0| 69 6e 74 65 64 20 61 74 | 20 69 6e 20 70 61 72 61 |inted at| in para|
|000025f0| 6d 32 20 69 73 20 61 20 | 63 6f 6d 70 72 65 73 73 |m2 is a |compress|
|00002600| 20 73 6f 75 6e 64 20 68 | 65 61 64 65 72 2c 20 74 | sound h|eader, t|
|00002610| 68 65 6e 20 74 68 65 20 | 63 6f 6e 74 69 6e 75 65 |hen the |continue|
|00002620| 43 6d 64 20 77 69 6c 6c | 20 6e 6f 74 20 72 65 73 |Cmd will| not res|
|00002630| 65 73 74 20 74 68 65 20 | 69 6e 74 65 72 6e 61 6c |est the |internal|
|00002640| 20 73 74 61 72 74 20 76 | 61 72 69 61 62 6c 65 73 | start v|ariables|
|00002650| 20 66 6f 72 20 64 65 63 | 6f 6d 70 72 65 73 73 69 | for dec|ompressi|
|00002660| 6e 67 20 61 20 4d 41 43 | 45 20 73 6f 75 6e 64 2e |ng a MAC|E sound.|
|00002670| 20 20 54 68 69 73 20 6d | 65 61 6e 73 20 74 68 61 | This m|eans tha|
|00002680| 74 20 74 68 65 20 65 6e | 64 73 20 6f 66 20 62 75 |t the en|ds of bu|
|00002690| 66 66 65 72 73 20 77 69 | 6c 6c 20 6e 6f 74 20 63 |ffers wi|ll not c|
|000026a0| 61 75 73 65 20 61 20 63 | 6c 69 63 6b 20 74 6f 20 |ause a c|lick to |
|000026b0| 62 65 20 68 65 61 64 65 | 72 20 69 66 20 66 6f 6c |be heade|r if fol|
|000026c0| 6c 6f 77 65 64 20 62 79 | 20 61 6e 6f 74 68 65 72 |lowed by| another|
|000026d0| 20 4d 41 43 45 20 73 6f | 75 6e 64 2e 20 20 54 68 | MACE so|und. Th|
|000026e0| 69 73 20 61 6c 6c 6f 77 | 73 20 73 65 61 6d 6c 65 |is allow|s seamle|
|000026f0| 73 73 20 64 6f 75 62 6c | 65 20 62 75 66 66 65 72 |ss doubl|e buffer|
|00002700| 69 6e 67 20 6f 66 20 4d | 41 43 45 20 73 6f 75 6e |ing of M|ACE soun|
|00002710| 64 73 2e 0d 4f 74 68 65 | 72 20 4e 6f 74 65 73 0d |ds..Othe|r Notes.|
|00002720| 41 6c 6c 20 74 68 65 20 | 69 6e 66 6f 72 6d 61 74 |All the |informat|
|00002730| 69 6f 6e 20 74 68 61 74 | 20 61 70 70 6c 69 65 73 |ion that| applies|
|00002740| 20 74 6f 20 74 68 65 20 | 62 75 66 66 65 72 43 6d | to the |bufferCm|
|00002750| 64 20 61 70 70 6c 69 65 | 73 20 74 6f 20 74 68 65 |d applie|s to the|
|00002760| 20 63 6f 6e 74 69 6e 75 | 65 43 6d 64 20 61 73 20 | continu|eCmd as |
|00002770| 77 65 6c 6c 2e 0d 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |well..__|________|
|00002780| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002790| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 63 6f 6e 76 65 |________|__.conve|
|000027a0| 72 74 43 6d 64 0d 4e 6f | 74 65 73 0d 41 70 70 6c |rtCmd.No|tes.Appl|
|000027b0| 69 63 61 74 69 6f 6e 73 | 20 73 68 6f 75 6c 64 20 |ications| should |
|000027c0| 6e 65 76 65 72 20 75 73 | 65 20 74 68 69 73 20 63 |never us|e this c|
|000027d0| 6f 6d 6d 61 6e 64 2e 20 | 20 49 74 20 69 73 20 6e |ommand. | It is n|
|000027e0| 6f 20 6c 6f 6e 67 65 72 | 20 73 75 70 70 6f 72 74 |o longer| support|
|000027f0| 65 64 2e 20 20 54 68 69 | 73 20 77 61 73 20 61 20 |ed. Thi|s was a |
|00002800| 68 61 63 6b 20 74 6f 20 | 6d 61 6b 65 20 74 68 65 |hack to |make the|
|00002810| 20 6f 72 69 67 69 6e 61 | 6c 20 76 65 72 73 69 6f | origina|l versio|
|00002820| 6e 20 6f 66 20 4d 41 43 | 45 20 74 68 61 74 20 73 |n of MAC|E that s|
|00002830| 68 69 70 20 74 68 72 6f | 75 67 68 20 41 50 44 41 |hip thro|ugh APDA|
|00002840| 20 77 6f 72 6b 20 77 69 | 74 68 20 74 68 65 20 6f | work wi|th the o|
|00002850| 6c 64 65 72 20 53 6f 75 | 6e 64 20 4d 61 6e 61 67 |lder Sou|nd Manag|
|00002860| 65 72 2e 20 20 54 68 69 | 73 20 77 61 73 20 74 68 |er. Thi|s was th|
|00002870| 65 20 76 65 72 73 69 6f | 6e 20 6f 66 20 4d 41 43 |e versio|n of MAC|
|00002880| 45 20 74 68 61 74 20 68 | 61 64 20 74 6f 20 62 65 |E that h|ad to be|
|00002890| 20 69 6e 73 74 61 6c 6c | 65 64 20 69 6e 74 6f 20 | install|ed into |
|000028a0| 74 68 65 20 53 79 73 74 | 65 6d 20 66 69 6c 65 20 |the Syst|em file |
|000028b0| 62 79 20 72 75 6e 6e 69 | 6e 67 20 74 68 65 20 49 |by runni|ng the I|
|000028c0| 6e 73 74 61 6c 6c 65 72 | 20 61 70 70 6c 69 63 61 |nstaller| applica|
|000028d0| 74 69 6f 6e 2e 20 20 54 | 68 69 73 20 6f 6c 64 65 |tion. T|his olde|
|000028e0| 72 20 76 65 72 73 69 6f | 6e 20 6f 66 20 4d 41 43 |r versio|n of MAC|
|000028f0| 45 20 64 6f 65 73 20 6e | 6f 74 20 77 6f 72 6b 20 |E does n|ot work |
|00002900| 69 6e 20 53 79 73 74 65 | 6d 20 36 2e 30 2e 37 20 |in Syste|m 6.0.7 |
|00002910| 6f 72 20 6c 61 74 65 72 | 2e 20 20 54 68 65 73 65 |or later|. These|
|00002920| 20 73 79 73 74 65 6d 73 | 20 68 61 76 65 20 4d 41 | systems| have MA|
|00002930| 43 45 20 62 75 69 6c 74 | 2d 69 6e 2e 20 20 45 76 |CE built|-in. Ev|
|00002940| 65 72 79 6f 6e 65 20 73 | 68 6f 75 6c 64 20 62 65 |eryone s|hould be|
|00002950| 20 75 73 69 6e 67 20 74 | 68 65 20 6e 65 77 20 74 | using t|he new t|
|00002960| 72 61 70 73 20 69 6e 73 | 74 65 61 64 2e 0d 5f 5f |raps ins|tead..__|
|00002970| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002980| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002990| 5f 5f 0d 64 6f 75 62 6c | 65 42 75 66 66 65 72 43 |__.doubl|eBufferC|
|000029a0| 6d 64 0d 4e 6f 74 65 73 | 0d 41 70 70 6c 69 63 61 |md.Notes|.Applica|
|000029b0| 74 69 6f 6e 73 20 73 68 | 6f 75 6c 64 20 6e 65 76 |tions sh|ould nev|
|000029c0| 65 72 20 75 73 65 20 74 | 68 69 73 20 63 6f 6d 6d |er use t|his comm|
|000029d0| 61 6e 64 2e 20 20 54 68 | 69 73 20 63 6f 6d 6d 61 |and. Th|is comma|
|000029e0| 6e 64 20 69 73 20 6f 6e | 6c 79 20 73 65 6e 74 20 |nd is on|ly sent |
|000029f0| 62 79 20 74 68 65 20 53 | 6f 75 6e 64 20 4d 61 6e |by the S|ound Man|
|00002a00| 61 67 65 72 20 74 6f 20 | 69 6d 70 6c 65 6d 65 6e |ager to |implemen|
|00002a10| 74 20 53 6e 64 50 6c 61 | 79 44 6f 75 62 6c 65 42 |t SndPla|yDoubleB|
|00002a20| 75 66 66 65 72 2e 20 20 | 54 68 69 73 20 63 6f 6d |uffer. |This com|
|00002a30| 6d 61 6e 64 20 77 69 6c | 6c 20 69 6e 20 61 6c 6c |mand wil|l in all|
|00002a40| 20 6c 69 6b 65 6c 79 68 | 6f 6f 64 20 62 65 20 72 | likelyh|ood be r|
|00002a50| 65 6d 6f 76 65 64 20 61 | 6e 64 20 53 6e 64 50 6c |emoved a|nd SndPl|
|00002a60| 61 79 44 6f 75 62 6c 65 | 42 75 66 66 65 72 20 77 |ayDouble|Buffer w|
|00002a70| 69 6c 6c 20 62 65 20 72 | 65 77 72 69 74 74 65 6e |ill be r|ewritten|
|00002a80| 2e 0d 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..______|________|
|00002a90| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002aa0| 5f 5f 5f 5f 5f 5f 0d 65 | 6d 70 74 79 43 6d 64 0d |______.e|mptyCmd.|
|00002ab0| 4e 6f 74 65 73 0d 41 70 | 70 6c 69 63 61 74 69 6f |Notes.Ap|plicatio|
|00002ac0| 6e 73 20 73 68 6f 75 6c | 64 20 6e 65 76 65 72 20 |ns shoul|d never |
|00002ad0| 75 73 65 20 74 68 69 73 | 20 63 6f 6d 6d 61 6e 64 |use this| command|
|00002ae0| 2e 20 20 53 79 6e 74 68 | 65 73 69 7a 65 72 73 20 |. Synth|esizers |
|00002af0| 65 78 70 65 63 74 20 74 | 6f 20 72 65 63 65 69 76 |expect t|o receiv|
|00002b00| 65 20 61 64 64 69 74 69 | 6f 6e 61 6c 20 63 6f 6d |e additi|onal com|
|00002b10| 6d 61 6e 64 73 20 61 66 | 74 65 72 20 61 20 72 65 |mands af|ter a re|
|00002b20| 73 75 6d 65 43 6d 64 2e | 20 20 49 66 20 6e 6f 20 |sumeCmd.| If no |
|00002b30| 6f 74 68 65 72 20 63 6f | 6d 6d 61 6e 64 73 20 61 |other co|mmands a|
|00002b40| 72 65 20 74 6f 20 62 65 | 20 73 65 6e 74 2c 20 74 |re to be| sent, t|
|00002b50| 68 65 20 53 6f 75 6e 64 | 20 4d 61 6e 61 67 65 72 |he Sound| Manager|
|00002b60| 20 77 69 6c 6c 20 73 65 | 6e 64 20 61 6e 20 65 6d | will se|nd an em|
|00002b70| 70 74 79 43 6d 64 2e 0d | 5f 5f 5f 5f 5f 5f 5f 5f |ptyCmd..|________|
|00002b80| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002b90| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 66 6c 75 |________|____.flu|
|00002ba0| 73 68 43 6d 64 0d 70 61 | 72 61 6d 31 09 30 20 28 |shCmd.pa|ram1.0 (|
|00002bb0| 69 67 6e 6f 72 65 64 20 | 6f 6e 20 69 6e 70 75 74 |ignored |on input|
|00002bc0| 20 61 6e 64 20 6f 75 74 | 70 75 74 29 0d 70 61 72 | and out|put).par|
|00002bd0| 61 6d 32 09 30 20 28 69 | 67 6e 6f 72 65 64 20 6f |am2.0 (i|gnored o|
|00002be0| 6e 20 69 6e 70 75 74 20 | 61 6e 64 20 6f 75 74 70 |n input |and outp|
|00002bf0| 75 74 29 0d 52 65 6d 6f | 76 65 73 20 61 6c 6c 20 |ut).Remo|ves all |
|00002c00| 63 6f 6d 6d 61 6e 64 73 | 20 63 75 72 72 65 6e 74 |commands| current|
|00002c10| 6c 79 20 71 75 65 75 65 | 64 20 69 6e 20 74 68 65 |ly queue|d in the|
|00002c20| 20 73 70 65 63 69 66 69 | 65 64 20 73 6f 75 6e 64 | specifi|ed sound|
|00002c30| 20 63 68 61 6e 6e 65 6c | 2e 20 41 20 66 6c 75 73 | channel|. A flus|
|00002c40| 68 43 6d 64 20 63 6f 6d | 6d 61 6e 64 20 64 6f 65 |hCmd com|mand doe|
|00002c50| 73 20 6e 6f 74 20 61 66 | 66 65 63 74 20 61 6e 79 |s not af|fect any|
|00002c60| 20 73 6f 75 6e 64 20 74 | 68 61 74 20 69 73 20 63 | sound t|hat is c|
|00002c70| 75 72 72 65 6e 74 6c 79 | 20 69 6e 20 70 72 6f 67 |urrently| in prog|
|00002c80| 72 65 73 73 2e 20 59 6f | 75 20 63 61 6e 20 73 65 |ress. Yo|u can se|
|00002c90| 6e 64 20 66 6c 75 73 68 | 43 6d 64 20 74 6f 20 61 |nd flush|Cmd to a|
|00002ca0| 6e 79 20 6f 66 20 74 68 | 65 20 61 76 61 69 6c 61 |ny of th|e availa|
|00002cb0| 62 6c 65 20 73 79 6e 74 | 68 65 73 69 7a 65 72 73 |ble synt|hesizers|
|00002cc0| 2c 20 62 75 74 20 79 6f | 75 20 73 68 6f 75 6c 64 |, but yo|u should|
|00002cd0| 20 73 65 6e 64 20 69 74 | 20 62 79 20 75 73 69 6e | send it| by usin|
|00002ce0| 67 20 53 6e 64 44 6f 49 | 6d 6d 65 64 69 61 74 65 |g SndDoI|mmediate|
|00002cf0| 2e 0d 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..______|________|
|00002d00| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002d10| 5f 5f 5f 5f 5f 5f 0d 66 | 72 65 65 43 6d 64 0d 54 |______.f|reeCmd.T|
|00002d20| 68 69 73 20 63 6f 6d 6d | 61 6e 64 20 69 73 20 65 |his comm|and is e|
|00002d30| 78 61 63 74 6c 79 20 6f | 70 70 6f 73 69 74 65 20 |xactly o|pposite |
|00002d40| 6f 66 20 74 68 65 20 69 | 6e 69 74 43 6d 64 2e 20 |of the i|nitCmd. |
|00002d50| 20 57 68 65 6e 20 61 6e | 20 61 70 70 6c 69 63 61 | When an| applica|
|00002d60| 74 69 6f 6e 20 63 61 6c | 6c 73 20 53 6e 64 44 69 |tion cal|ls SndDi|
|00002d70| 73 70 6f 73 65 43 68 61 | 6e 6e 65 6c 2c 20 74 68 |sposeCha|nnel, th|
|00002d80| 65 20 53 6f 75 6e 64 20 | 4d 61 6e 61 67 65 72 20 |e Sound |Manager |
|00002d90| 77 69 6c 6c 20 73 65 6e | 64 20 74 68 65 20 66 72 |will sen|d the fr|
|00002da0| 65 65 43 6d 64 20 74 6f | 20 74 68 65 20 73 79 6e |eeCmd to| the syn|
|00002db0| 74 68 65 73 69 7a 65 72 | 2e 20 20 54 68 69 73 20 |thesizer|. This |
|00002dc0| 63 61 75 73 65 73 20 74 | 68 65 20 73 79 6e 74 68 |causes t|he synth|
|00002dd0| 65 73 69 7a 65 72 20 74 | 6f 20 64 69 73 70 6f 73 |esizer t|o dispos|
|00002de0| 65 20 6f 66 20 61 6c 6c | 20 74 68 65 20 70 72 69 |e of all| the pri|
|00002df0| 76 61 74 65 20 6d 65 6d | 6f 72 79 20 69 74 20 68 |vate mem|ory it h|
|00002e00| 61 64 20 61 6c 6c 6f 63 | 61 74 65 64 2e 0d 4e 6f |ad alloc|ated..No|
|00002e10| 74 65 73 0d 41 70 70 6c | 69 63 61 74 69 6f 6e 73 |tes.Appl|ications|
|00002e20| 20 73 68 6f 75 6c 64 20 | 6e 65 76 65 72 20 75 73 | should |never us|
|00002e30| 65 20 74 68 69 73 20 63 | 6f 6d 6d 61 6e 64 2e 20 |e this c|ommand. |
|00002e40| 20 49 74 20 69 73 20 61 | 6e 20 69 6e 74 65 72 6e | It is a|n intern|
|00002e50| 61 6c 20 63 6f 6d 6d 61 | 6e 64 20 66 6f 72 20 74 |al comma|nd for t|
|00002e60| 68 65 20 53 6f 75 6e 64 | 20 4d 61 6e 61 67 65 72 |he Sound| Manager|
|00002e70| 2e 0d 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..______|________|
|00002e80| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002e90| 5f 5f 5f 5f 5f 5f 0d 66 | 72 65 71 43 6d 64 0d 70 |______.f|reqCmd.p|
|00002ea0| 61 72 61 6d 31 09 30 20 | 28 69 67 6e 6f 72 65 64 |aram1.0 |(ignored|
|00002eb0| 20 6f 6e 20 69 6e 70 75 | 74 20 61 6e 64 20 6f 75 | on inpu|t and ou|
|00002ec0| 74 70 75 74 29 0d 70 61 | 72 61 6d 32 09 64 65 73 |tput).pa|ram2.des|
|00002ed0| 69 72 65 64 20 66 72 65 | 71 75 65 6e 63 79 0d 43 |ired fre|quency.C|
|00002ee0| 68 61 6e 67 65 73 20 74 | 68 65 20 66 72 65 71 75 |hanges t|he frequ|
|00002ef0| 65 6e 63 79 20 28 6f 72 | 20 70 69 74 63 68 29 20 |ency (or| pitch) |
|00002f00| 6f 66 20 61 20 73 6f 75 | 6e 64 2e 20 49 66 20 6e |of a sou|nd. If n|
|00002f10| 6f 20 73 6f 75 6e 64 20 | 69 73 20 63 75 72 72 65 |o sound |is curre|
|00002f20| 6e 74 6c 79 20 70 6c 61 | 79 69 6e 67 2c 20 74 68 |ntly pla|ying, th|
|00002f30| 65 6e 20 66 72 65 71 43 | 6d 64 20 63 61 75 73 65 |en freqC|md cause|
|00002f40| 73 20 74 68 65 20 73 79 | 6e 74 68 65 73 69 7a 65 |s the sy|nthesize|
|00002f50| 72 20 6c 69 6e 6b 65 64 | 20 74 6f 20 74 68 65 20 |r linked| to the |
|00002f60| 73 70 65 63 69 66 69 65 | 64 20 63 68 61 6e 6e 65 |specifie|d channe|
|00002f70| 6c 20 74 6f 20 62 65 67 | 69 6e 20 70 6c 61 79 69 |l to beg|in playi|
|00002f80| 6e 67 20 69 6e 64 65 66 | 69 6e 69 74 65 6c 79 20 |ng indef|initely |
|00002f90| 61 74 20 74 68 65 20 66 | 72 65 71 75 65 6e 63 79 |at the f|requency|
|00002fa0| 20 73 70 65 63 69 66 69 | 65 64 20 69 6e 20 70 61 | specifi|ed in pa|
|00002fb0| 72 61 6d 32 2e 20 49 66 | 2c 20 68 6f 77 65 76 65 |ram2. If|, howeve|
|00002fc0| 72 2c 20 74 68 65 20 63 | 68 61 6e 6e 65 6c 20 69 |r, the c|hannel i|
|00002fd0| 73 20 6c 69 6e 6b 65 64 | 20 74 6f 20 74 68 65 20 |s linked| to the |
|00002fe0| 77 61 76 65 2d 74 61 62 | 6c 65 20 6f 72 20 73 61 |wave-tab|le or sa|
|00002ff0| 6d 70 6c 65 64 20 73 6f | 75 6e 64 20 73 79 6e 74 |mpled so|und synt|
|00003000| 68 65 73 69 7a 65 72 20 | 61 6e 64 20 6e 6f 20 69 |hesizer |and no i|
|00003010| 6e 73 74 72 75 6d 65 6e | 74 20 69 73 20 69 6e 73 |nstrumen|t is ins|
|00003020| 74 61 6c 6c 65 64 20 69 | 6e 20 74 68 65 20 63 68 |talled i|n the ch|
|00003030| 61 6e 6e 65 6c 2c 20 6e | 6f 20 73 6f 75 6e 64 20 |annel, n|o sound |
|00003040| 69 73 20 70 72 6f 64 75 | 63 65 64 2e 20 54 68 65 |is produ|ced. The|
|00003050| 20 70 61 72 61 6d 32 20 | 70 61 72 61 6d 65 74 65 | param2 |paramete|
|00003060| 72 20 6d 75 73 74 20 63 | 6f 6e 74 61 69 6e 20 61 |r must c|ontain a|
|00003070| 20 76 61 6c 75 65 20 69 | 6e 20 74 68 65 20 72 61 | value i|n the ra|
|00003080| 6e 67 65 20 30 20 74 6f | 20 31 32 37 2e 20 54 68 |nge 0 to| 127. Th|
|00003090| 65 20 66 72 65 71 43 6d | 64 20 63 6f 6d 6d 61 6e |e freqCm|d comman|
|000030a0| 64 20 69 73 20 69 64 65 | 6e 74 69 63 61 6c 20 74 |d is ide|ntical t|
|000030b0| 6f 20 74 68 65 20 66 72 | 65 71 44 75 72 61 74 69 |o the fr|eqDurati|
|000030c0| 6f 6e 43 6d 64 20 63 6f | 6d 6d 61 6e 64 2c 20 65 |onCmd co|mmand, e|
|000030d0| 78 63 65 70 74 20 74 68 | 61 74 20 6e 6f 20 64 75 |xcept th|at no du|
|000030e0| 72 61 74 69 6f 6e 20 69 | 73 20 73 70 65 63 69 66 |ration i|s specif|
|000030f0| 69 65 64 20 74 6f 20 61 | 20 66 72 65 71 43 6d 64 |ied to a| freqCmd|
|00003100| 20 63 6f 6d 6d 61 6e 64 | 2e 20 59 6f 75 20 63 61 | command|. You ca|
|00003110| 6e 20 73 65 6e 64 20 66 | 72 65 71 43 6d 64 20 74 |n send f|reqCmd t|
|00003120| 6f 20 61 6e 79 20 6f 66 | 20 74 68 65 20 61 76 61 |o any of| the ava|
|00003130| 69 6c 61 62 6c 65 20 73 | 79 6e 74 68 65 73 69 7a |ilable s|ynthesiz|
|00003140| 65 72 73 2e 0d 4e 6f 74 | 65 73 0d 57 61 73 20 6f |ers..Not|es.Was o|
|00003150| 72 69 67 69 6e 61 6c 6c | 79 20 64 65 66 69 6e 65 |riginall|y define|
|00003160| 64 20 74 6f 20 73 75 70 | 70 6f 72 74 20 61 72 62 |d to sup|port arb|
|00003170| 69 74 72 61 72 79 20 66 | 72 65 71 75 65 6e 63 69 |itrary f|requenci|
|00003180| 65 73 2e 20 20 54 68 69 | 73 20 77 61 73 20 6e 65 |es. Thi|s was ne|
|00003190| 76 65 72 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 2c |ver impl|emented,|
|000031a0| 20 61 6e 64 20 68 61 73 | 20 62 65 65 6e 20 64 65 | and has| been de|
|000031b0| 74 65 72 6d 69 6e 65 64 | 20 61 73 20 62 65 69 6e |termined| as bein|
|000031c0| 67 20 69 6e 73 75 70 70 | 6f 72 74 61 62 6c 65 2e |g insupp|ortable.|
|000031d0| 20 20 54 68 65 20 6f 72 | 69 67 69 6e 61 6c 20 64 | The or|iginal d|
|000031e0| 65 66 69 6e 69 74 69 6f | 6e 20 77 61 73 20 74 68 |efinitio|n was th|
|000031f0| 61 74 20 74 68 65 20 66 | 72 65 71 75 65 6e 63 79 |at the f|requency|
|00003200| 20 77 61 73 20 64 65 66 | 69 6e 65 64 20 61 73 20 | was def|ined as |
|00003210| 74 68 65 20 6c 6f 77 65 | 72 20 74 68 72 65 65 20 |the lowe|r three |
|00003220| 62 79 74 65 73 20 6f 66 | 20 70 61 72 61 6d 32 2e |bytes of| param2.|
|00003230| 20 20 54 68 65 20 75 70 | 70 65 72 20 62 79 74 65 | The up|per byte|
|00003240| 20 77 61 73 20 69 67 6e | 6f 72 65 64 2e 20 20 42 | was ign|ored. B|
|00003250| 75 74 20 69 74 20 77 6f | 75 6c 64 6e d5 74 20 62 |ut it wo|uldn.t b|
|00003260| 65 20 70 6f 73 73 69 62 | 6c 65 20 74 6f 20 64 65 |e possib|le to de|
|00003270| 66 69 6e 65 20 61 20 74 | 68 72 65 65 2d 62 79 74 |fine a t|hree-byt|
|00003280| 65 20 76 61 6c 75 65 20 | 74 68 61 74 20 63 6f 75 |e value |that cou|
|00003290| 6c 64 20 73 70 65 63 69 | 66 79 20 66 72 65 71 75 |ld speci|fy frequ|
|000032a0| 65 6e 63 69 65 73 2e 20 | 20 46 69 6e 61 6c 6c 79 |encies. | Finally|
|000032b0| 2c 20 74 68 65 20 74 72 | 75 65 20 64 65 66 69 6e |, the tr|ue defin|
|000032c0| 69 74 69 6f 6e 20 66 6f | 72 20 68 6f 77 20 74 6f |ition fo|r how to|
|000032d0| 20 73 70 65 63 69 66 79 | 20 61 20 66 72 65 71 75 | specify| a frequ|
|000032e0| 65 6e 63 79 20 77 61 73 | 20 6e 65 76 65 72 20 64 |ency was| never d|
|000032f0| 6f 63 75 6d 65 6e 74 65 | 64 2e 0d 54 68 69 73 20 |ocumente|d..This |
|00003300| 63 6f 6d 6d 61 6e 64 20 | 77 69 6c 6c 20 63 61 75 |command |will cau|
|00003310| 73 65 20 74 68 65 20 6e | 6f 74 65 20 74 6f 20 70 |se the n|ote to p|
|00003320| 6c 61 79 20 6c 6f 6f 70 | 69 6e 67 20 66 6f 72 65 |lay loop|ing fore|
|00003330| 76 65 72 20 75 6e 74 69 | 6c 20 61 20 6e 65 77 20 |ver unti|l a new |
|00003340| 63 6f 6d 6d 61 6e 64 20 | 73 75 63 68 20 61 73 20 |command |such as |
|00003350| 74 68 65 20 71 75 69 74 | 65 43 6d 64 20 69 74 20 |the quit|eCmd it |
|00003360| 73 65 6e 74 2e 20 20 49 | 66 20 74 68 65 72 65 20 |sent. I|f there |
|00003370| 77 65 72 65 20 6e 6f 20 | 6f 74 68 65 72 20 63 6f |were no |other co|
|00003380| 6d 6d 61 6e 64 73 20 74 | 6f 20 62 65 20 70 72 6f |mmands t|o be pro|
|00003390| 63 65 73 73 65 64 2c 20 | 74 68 69 73 20 73 6f 75 |cessed, |this sou|
|000033a0| 6e 64 20 6e 65 76 65 72 | 20 73 74 6f 70 73 2e 20 |nd never| stops. |
|000033b0| 20 49 66 20 74 68 65 20 | 63 6f 6d 6d 61 6e 64 20 | If the |command |
|000033c0| 77 61 73 20 73 65 6e 74 | 20 74 6f 20 74 68 65 20 |was sent| to the |
|000033d0| 73 61 6d 70 6c 65 64 53 | 6f 75 6e 64 53 6e 74 68 |sampledS|oundSnth|
|000033e0| 20 74 68 65 20 73 6f 75 | 6e 64 20 68 65 61 64 65 | the sou|nd heade|
|000033f0| 72 20 62 65 69 6e 67 20 | 75 73 65 64 20 6d 75 73 |r being |used mus|
|00003400| 74 20 63 6f 6e 74 61 69 | 6e 20 6c 6f 6f 70 20 70 |t contai|n loop p|
|00003410| 6f 69 6e 74 73 2e 20 20 | 4f 74 68 65 72 77 69 73 |oints. |Otherwis|
|00003420| 65 20 74 68 65 20 73 6f | 75 6e 64 20 63 6f 75 6c |e the so|und coul|
|00003430| 64 20 6f 6e 6c 79 20 62 | 65 20 70 6c 61 79 65 64 |d only b|e played|
|00003440| 20 69 6e 20 6f 6e 65 20 | 73 68 6f 74 20 6d 6f 64 | in one |shot mod|
|00003450| 65 2e 0d 42 65 63 61 75 | 73 65 20 6f 66 20 62 75 |e..Becau|se of bu|
|00003460| 67 73 20 69 6e 20 74 68 | 65 20 28 53 79 73 74 65 |gs in th|e (Syste|
|00003470| 6d 20 36 2e 30 2e 32 3f | 29 20 73 61 6d 70 6c 65 |m 6.0.2?|) sample|
|00003480| 64 53 6f 75 6e 64 53 6e | 74 68 2c 20 73 6f 6d 65 |dSoundSn|th, some|
|00003490| 20 64 65 76 65 6c 6f 70 | 65 72 73 20 63 72 65 61 | develop|ers crea|
|000034a0| 74 65 64 20 6c 6f 6f 70 | 20 70 6f 69 6e 74 73 20 |ted loop| points |
|000034b0| 77 68 69 63 68 20 77 65 | 72 65 20 70 6f 69 6e 74 |which we|re point|
|000034c0| 69 6e 67 20 61 74 20 74 | 68 65 20 6c 61 73 74 20 |ing at t|he last |
|000034d0| 6f 6e 65 20 6f 72 20 74 | 77 6f 20 62 79 74 65 73 |one or t|wo bytes|
|000034e0| 20 6f 66 20 74 68 65 20 | 73 61 6d 70 6c 65 2e 20 | of the |sample. |
|000034f0| 20 53 69 6e 63 65 20 79 | 6f 75 20 63 61 6e 6e 6f | Since y|ou canno|
|00003500| 74 20 6c 6f 6f 70 20 6f | 6e 20 61 20 66 65 77 20 |t loop o|n a few |
|00003510| 62 79 74 65 73 20 6f 66 | 20 61 20 73 61 6d 70 6c |bytes of| a sampl|
|00003520| 65 20 61 6e 64 20 72 65 | 70 72 6f 64 75 63 65 20 |e and re|produce |
|00003530| 74 68 65 20 73 6f 75 6e | 64 2c 20 74 68 65 20 53 |the soun|d, the S|
|00003540| 6f 75 6e 64 20 4d 61 6e | 61 67 65 72 20 68 61 73 |ound Man|ager has|
|00003550| 20 74 6f 20 73 70 65 63 | 69 61 6c 20 63 61 73 65 | to spec|ial case|
|00003560| 20 74 68 69 73 20 61 6e | 64 20 63 6f 6e 73 69 64 | this an|d consid|
|00003570| 65 72 20 74 68 65 20 73 | 6f 75 6e 64 20 61 73 20 |er the s|ound as |
|00003580| 6e 6f 74 20 68 61 76 69 | 6e 67 20 61 6e 79 20 6c |not havi|ng any l|
|00003590| 6f 6f 70 20 70 6f 69 6e | 74 73 2e 20 20 54 68 69 |oop poin|ts. Thi|
|000035a0| 73 20 69 73 20 61 6c 6c | 20 64 75 65 20 74 6f 20 |s is all| due to |
|000035b0| 61 20 62 75 67 20 74 68 | 61 74 20 65 78 69 73 74 |a bug th|at exist|
|000035c0| 65 64 20 69 6e 20 74 68 | 65 20 6f 72 69 67 69 6e |ed in th|e origin|
|000035d0| 61 6c 20 53 6f 75 6e 64 | 20 4d 61 6e 61 67 65 72 |al Sound| Manager|
|000035e0| 20 61 6e 64 20 64 65 76 | 65 6c 6f 70 65 72 73 20 | and dev|elopers |
|000035f0| 64 69 73 63 6f 76 65 72 | 65 64 20 74 68 69 73 20 |discover|ed this |
|00003600| 77 6f 72 6b 20 61 72 6f | 75 6e 64 20 28 62 65 63 |work aro|und (bec|
|00003610| 61 75 73 65 20 73 6f 6d | 65 6f 6e 65 20 61 74 20 |ause som|eone at |
|00003620| 41 70 70 6c 65 20 72 65 | 63 6f 6d 6d 65 6e 64 20 |Apple re|commend |
|00003630| 74 68 69 73 20 61 73 20 | 61 20 d2 73 6f 6c 75 74 |this as |a .solut|
|00003640| 69 6f 6e d3 29 20 61 6e | 64 20 62 65 63 61 75 73 |ion.) an|d becaus|
|00003650| 65 20 6f 66 20 74 68 69 | 73 20 77 65 20 68 61 76 |e of thi|s we hav|
|00003660| 65 20 74 6f 20 63 6f 6e | 74 69 6e 75 65 20 73 75 |e to con|tinue su|
|00003670| 70 70 6f 72 74 69 6e 67 | 20 69 74 73 20 62 65 68 |pporting| its beh|
|00003680| 61 76 69 6f 72 2e 20 20 | 48 79 70 65 72 43 61 72 |avior. |HyperCar|
|00003690| 64 20 66 6f 72 20 65 78 | 61 6d 70 6c 65 20 72 65 |d for ex|ample re|
|000036a0| 6c 69 65 73 20 6f 6e 20 | 74 68 69 73 2e 0d 43 61 |lies on |this..Ca|
|000036b0| 6e 6e 6f 74 20 62 65 20 | 75 73 65 64 20 77 69 74 |nnot be |used wit|
|000036c0| 68 20 73 6f 75 6e 64 20 | 68 65 61 64 65 72 73 20 |h sound |headers |
|000036d0| 74 68 61 74 20 61 72 65 | 20 63 6f 6d 70 72 65 73 |that are| compres|
|000036e0| 73 65 64 2e 0d 41 20 6e | 6f 74 65 20 76 61 6c 75 |sed..A n|ote valu|
|000036f0| 65 20 6f 66 20 30 20 6d | 65 61 6e 73 20 71 75 69 |e of 0 m|eans qui|
|00003700| 65 74 43 6d 64 2e 0d 49 | 66 20 74 68 65 72 65 20 |etCmd..I|f there |
|00003710| 61 72 65 20 61 6e 79 20 | 61 64 64 69 74 69 6f 6e |are any |addition|
|00003720| 61 6c 20 63 6f 6d 6d 61 | 6e 64 73 20 69 6e 20 74 |al comma|nds in t|
|00003730| 68 65 20 71 75 65 75 65 | 20 74 68 65 79 20 77 69 |he queue| they wi|
|00003740| 6c 6c 20 62 65 20 65 78 | 65 63 75 74 65 64 20 69 |ll be ex|ecuted i|
|00003750| 6d 6d 65 64 69 61 74 65 | 6c 79 20 61 66 74 65 72 |mmediate|ly after|
|00003760| 20 73 74 61 72 74 69 6e | 67 20 74 68 65 20 66 72 | startin|g the fr|
|00003770| 65 71 43 6d 64 2e 20 20 | 54 68 69 73 20 69 73 20 |eqCmd. |This is |
|00003780| 62 65 63 61 75 73 65 20 | 74 68 65 20 63 6f 6d 6d |because |the comm|
|00003790| 61 6e 64 20 68 61 73 20 | 6e 6f 20 64 75 72 61 74 |and has |no durat|
|000037a0| 69 6f 6e 2e 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ion..___|________|
|000037b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000037c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 66 72 65 71 44 75 |________|_.freqDu|
|000037d0| 72 61 74 69 6f 6e 43 6d | 64 0d 70 61 72 61 6d 31 |rationCm|d.param1|
|000037e0| 09 64 75 72 61 74 69 6f | 6e 20 69 6e 20 68 61 6c |.duratio|n in hal|
|000037f0| 66 2d 6d 69 6c 6c 69 73 | 65 63 6f 6e 64 73 20 28 |f-millis|econds (|
|00003800| 30 20 74 6f 20 33 32 2c | 37 36 37 29 0d 70 61 72 |0 to 32,|767).par|
|00003810| 61 6d 32 09 64 65 73 69 | 72 65 64 20 66 72 65 71 |am2.desi|red freq|
|00003820| 75 65 6e 63 79 0d 46 6f | 72 6d 61 6c 6c 79 20 6b |uency.Fo|rmally k|
|00003830| 6e 6f 77 6e 20 61 73 20 | 74 68 65 20 6e 6f 74 65 |nown as |the note|
|00003840| 43 6d 64 2e 0d 50 6c 61 | 79 73 20 74 68 65 20 66 |Cmd..Pla|ys the f|
|00003850| 72 65 71 75 65 6e 63 79 | 20 73 70 65 63 69 66 69 |requency| specifi|
|00003860| 65 64 20 69 6e 20 70 61 | 72 61 6d 32 20 66 6f 72 |ed in pa|ram2 for|
|00003870| 20 74 68 65 20 64 75 72 | 61 74 69 6f 6e 20 73 70 | the dur|ation sp|
|00003880| 65 63 69 66 69 65 64 20 | 69 6e 20 70 61 72 61 6d |ecified |in param|
|00003890| 31 2e 20 54 68 65 20 70 | 61 72 61 6d 32 20 70 61 |1. The p|aram2 pa|
|000038a0| 72 61 6d 65 74 65 72 20 | 6d 75 73 74 20 63 6f 6e |rameter |must con|
|000038b0| 74 61 69 6e 20 61 20 76 | 61 6c 75 65 20 69 6e 20 |tain a v|alue in |
|000038c0| 74 68 65 20 72 61 6e 67 | 65 20 30 20 74 6f 20 31 |the rang|e 0 to 1|
|000038d0| 32 37 2e 20 59 6f 75 20 | 63 61 6e 20 73 65 6e 64 |27. You |can send|
|000038e0| 20 66 72 65 71 44 75 72 | 61 74 69 6f 6e 43 6d 64 | freqDur|ationCmd|
|000038f0| 20 74 6f 20 61 6e 79 20 | 6f 66 20 74 68 65 20 61 | to any |of the a|
|00003900| 76 61 69 6c 61 62 6c 65 | 20 73 79 6e 74 68 65 73 |vailable| synthes|
|00003910| 69 7a 65 72 73 2e 0d 52 | 65 66 65 72 20 74 6f 20 |izers..R|efer to |
|00003920| 74 68 65 20 61 6d 70 43 | 6d 64 2e 0d 4e 6f 74 65 |the ampC|md..Note|
|00003930| 73 0d 49 74 20 77 61 73 | 20 6f 72 69 67 69 6e 61 |s.It was| origina|
|00003940| 6c 6c 79 20 64 65 66 69 | 6e 65 64 20 74 6f 20 73 |lly defi|ned to s|
|00003950| 75 70 70 6f 72 74 20 61 | 72 62 72 61 74 72 61 79 |upport a|rbratray|
|00003960| 20 66 72 65 71 75 65 6e | 63 69 65 73 2e 20 20 54 | frequen|cies. T|
|00003970| 68 69 73 20 77 61 73 20 | 6e 65 76 65 72 20 69 6d |his was |never im|
|00003980| 70 6c 65 6d 65 6e 74 65 | 64 2c 20 61 6e 64 20 68 |plemente|d, and h|
|00003990| 61 73 20 62 65 65 6e 20 | 64 65 74 65 72 6d 69 6e |as been |determin|
|000039a0| 65 64 20 61 73 20 62 65 | 69 6e 67 20 69 6e 73 75 |ed as be|ing insu|
|000039b0| 70 70 6f 72 74 61 62 6c | 65 2e 20 20 54 68 65 20 |pportabl|e. The |
|000039c0| 6f 72 69 67 69 6e 61 6c | 20 64 65 66 69 6e 69 74 |original| definit|
|000039d0| 69 6f 6e 20 77 61 73 20 | 74 68 61 74 20 74 68 65 |ion was |that the|
|000039e0| 20 66 72 65 71 75 65 6e | 63 79 20 77 61 73 20 64 | frequen|cy was d|
|000039f0| 65 66 69 6e 65 64 20 61 | 73 20 74 68 65 20 6c 6f |efined a|s the lo|
|00003a00| 77 65 72 20 74 68 72 65 | 65 20 62 79 74 65 73 20 |wer thre|e bytes |
|00003a10| 6f 66 20 70 61 72 61 6d | 32 2e 20 20 54 68 65 20 |of param|2. The |
|00003a20| 75 70 70 65 72 20 62 79 | 74 65 20 77 61 73 20 69 |upper by|te was i|
|00003a30| 67 6e 6f 72 65 64 2e 20 | 20 42 75 74 20 69 74 20 |gnored. | But it |
|00003a40| 77 6f 75 6c 64 6e d5 74 | 20 62 65 20 70 6f 73 73 |wouldn.t| be poss|
|00003a50| 69 62 6c 65 20 74 6f 20 | 64 65 66 69 6e 65 20 61 |ible to |define a|
|00003a60| 20 74 68 72 65 65 2d 62 | 79 74 65 20 76 61 6c 75 | three-b|yte valu|
|00003a70| 65 20 74 68 61 74 20 63 | 6f 75 6c 64 20 73 70 65 |e that c|ould spe|
|00003a80| 63 69 66 79 20 66 72 65 | 71 75 65 6e 63 69 65 73 |cify fre|quencies|
|00003a90| 2e 20 20 46 69 6e 61 6c | 6c 79 2c 20 74 68 65 20 |. Final|ly, the |
|00003aa0| 74 72 75 65 20 64 65 66 | 69 6e 69 74 69 6f 6e 20 |true def|inition |
|00003ab0| 66 6f 72 20 68 6f 77 20 | 74 6f 20 73 70 65 63 69 |for how |to speci|
|00003ac0| 66 79 20 61 20 66 72 65 | 71 75 65 6e 63 79 20 77 |fy a fre|quency w|
|00003ad0| 61 73 20 6e 65 76 65 72 | 20 64 6f 63 75 6d 65 6e |as never| documen|
|00003ae0| 74 65 64 2e 0d 54 68 69 | 73 20 63 6f 6d 6d 61 6e |ted..Thi|s comman|
|00003af0| 64 20 77 69 6c 6c 20 63 | 61 75 73 65 20 74 68 65 |d will c|ause the|
|00003b00| 20 6e 6f 74 65 20 74 6f | 20 70 6f 73 73 69 62 6c | note to| possibl|
|00003b10| 79 20 70 6c 61 79 20 63 | 6f 6e 74 69 6e 75 6f 75 |y play c|ontinuou|
|00003b20| 73 6c 79 2c 20 6c 6f 6f | 70 69 6e 67 20 66 6f 72 |sly, loo|ping for|
|00003b30| 65 76 65 72 20 75 6e 74 | 69 6c 20 61 20 6e 65 77 |ever unt|il a new|
|00003b40| 20 63 6f 6d 6d 61 6e 64 | 20 73 75 63 68 20 61 73 | command| such as|
|00003b50| 20 74 68 65 20 71 75 69 | 74 65 43 6d 64 20 69 74 | the qui|teCmd it|
|00003b60| 20 73 65 6e 74 2e 20 20 | 49 66 20 74 68 65 72 65 | sent. |If there|
|00003b70| 20 77 65 72 65 20 6e 6f | 20 6f 74 68 65 72 20 63 | were no| other c|
|00003b80| 6f 6d 6d 61 6e 64 73 20 | 74 6f 20 62 65 20 70 72 |ommands |to be pr|
|00003b90| 6f 63 65 73 73 65 64 2c | 20 74 68 69 73 20 73 6f |ocessed,| this so|
|00003ba0| 75 6e 64 20 6e 65 76 65 | 72 20 73 74 6f 70 73 2e |und neve|r stops.|
|00003bb0| 20 20 49 66 20 74 68 65 | 20 63 6f 6d 6d 61 6e 64 | If the| command|
|00003bc0| 20 77 61 73 20 73 65 6e | 74 20 74 6f 20 74 68 65 | was sen|t to the|
|00003bd0| 20 73 61 6d 70 6c 65 64 | 53 6f 75 6e 64 53 6e 74 | sampled|SoundSnt|
|00003be0| 68 20 74 68 65 20 73 6f | 75 6e 64 20 68 65 61 64 |h the so|und head|
|00003bf0| 65 72 20 62 65 69 6e 67 | 20 75 73 65 64 20 6d 75 |er being| used mu|
|00003c00| 73 74 20 63 6f 6e 74 61 | 69 6e 20 6c 6f 6f 70 20 |st conta|in loop |
|00003c10| 70 6f 69 6e 74 73 2e 20 | 20 4f 74 68 65 72 77 69 |points. | Otherwi|
|00003c20| 73 65 20 74 68 65 20 73 | 6f 75 6e 64 20 63 6f 75 |se the s|ound cou|
|00003c30| 6c 64 20 6f 6e 6c 79 20 | 62 65 20 70 6c 61 79 65 |ld only |be playe|
|00003c40| 64 20 69 6e 20 6f 6e 65 | 20 73 68 6f 74 20 6d 6f |d in one| shot mo|
|00003c50| 64 65 2e 0d 4f 72 69 67 | 69 6e 61 6c 6c 79 20 64 |de..Orig|inally d|
|00003c60| 6f 63 75 6d 65 6e 74 65 | 64 20 61 73 20 73 75 70 |ocumente|d as sup|
|00003c70| 70 6f 72 74 69 6e 67 20 | 61 6e 20 61 6d 70 6c 69 |porting |an ampli|
|00003c80| 74 75 64 65 20 76 61 6c | 75 65 20 69 6e 20 74 68 |tude val|ue in th|
|00003c90| 65 20 68 69 67 68 20 62 | 79 74 65 20 6f 66 20 70 |e high b|yte of p|
|00003ca0| 61 72 61 6d 32 2c 20 62 | 75 74 20 61 74 20 74 68 |aram2, b|ut at th|
|00003cb0| 65 20 74 69 6d 65 20 74 | 68 65 20 53 6f 75 6e 64 |e time t|he Sound|
|00003cc0| 20 4d 61 6e 61 67 65 72 | 20 64 69 64 6e d5 74 20 | Manager| didn.t |
|00003cd0| 73 75 70 70 6f 72 74 20 | 61 6d 70 6c 69 74 75 64 |support |amplitud|
|00003ce0| 65 20 63 68 61 6e 67 65 | 73 2e 20 20 49 6e 20 66 |e change|s. In f|
|00003cf0| 61 63 74 2c 20 74 68 65 | 20 66 69 72 73 74 20 74 |act, the| first t|
|00003d00| 69 6d 65 20 74 68 65 20 | 53 6f 75 6e 64 20 4d 61 |ime the |Sound Ma|
|00003d10| 6e 61 67 65 72 20 73 75 | 70 70 6f 72 74 65 64 20 |nager su|pported |
|00003d20| 61 6d 70 6c 69 74 75 64 | 65 20 63 68 61 6e 67 65 |amplitud|e change|
|00003d30| 73 20 77 61 73 20 69 6e | 20 74 68 65 20 6e 65 77 |s was in| the new|
|00003d40| 20 53 6f 75 6e 64 20 4d | 61 6e 61 67 65 72 20 62 | Sound M|anager b|
|00003d50| 75 74 20 6f 6e 6c 79 20 | 62 79 20 75 73 69 6e 67 |ut only |by using|
|00003d60| 20 74 68 65 20 61 6d 70 | 43 6d 64 2e 20 20 45 76 | the amp|Cmd. Ev|
|00003d70| 65 6e 20 74 68 65 6e 20 | 69 74 20 77 61 73 6e d5 |en then |it wasn.|
|00003d80| 74 20 73 75 70 70 6f 72 | 74 65 64 20 62 79 20 61 |t suppor|ted by a|
|00003d90| 6c 6c 20 6f 66 20 74 68 | 65 20 73 6e 74 68 73 2c |ll of th|e snths,|
|00003da0| 20 62 75 74 20 6f 6e 6c | 79 20 62 79 20 74 68 65 | but onl|y by the|
|00003db0| 20 73 61 6d 70 6c 65 64 | 20 73 6f 75 6e 64 73 20 | sampled| sounds |
|00003dc0| 6f 6e 20 6d 61 63 68 69 | 6e 65 73 20 74 68 61 74 |on machi|nes that|
|00003dd0| 20 63 6f 6e 74 61 69 6e | 65 64 20 74 68 65 20 41 | contain|ed the A|
|00003de0| 70 70 6c 65 20 53 6f 75 | 6e 64 20 43 68 69 70 2e |pple Sou|nd Chip.|
|00003df0| 0d 53 79 73 74 65 6d 20 | 70 72 65 2d 36 2e 30 2e |.System |pre-6.0.|
|00003e00| 37 0d 42 65 63 61 75 73 | 65 20 6f 66 20 62 75 67 |7.Becaus|e of bug|
|00003e10| 73 20 69 6e 20 74 68 65 | 20 73 61 6d 70 6c 65 64 |s in the| sampled|
|00003e20| 53 6f 75 6e 64 53 6e 74 | 68 2c 20 73 6f 6d 65 20 |SoundSnt|h, some |
|00003e30| 64 65 76 65 6c 6f 70 65 | 72 73 20 63 72 65 61 74 |develope|rs creat|
|00003e40| 65 64 20 6c 6f 6f 70 20 | 70 6f 69 6e 74 73 20 77 |ed loop |points w|
|00003e50| 68 69 63 68 20 77 65 72 | 65 20 70 6f 69 6e 74 69 |hich wer|e pointi|
|00003e60| 6e 67 20 61 74 20 74 68 | 65 20 6c 61 73 74 20 6f |ng at th|e last o|
|00003e70| 6e 65 20 6f 72 20 74 77 | 6f 20 62 79 74 65 73 20 |ne or tw|o bytes |
|00003e80| 6f 66 20 74 68 65 20 73 | 61 6d 70 6c 65 2e 20 20 |of the s|ample. |
|00003e90| 53 69 6e 63 65 20 79 6f | 75 20 63 61 6e 6e 6f 74 |Since yo|u cannot|
|00003ea0| 20 6c 6f 6f 70 20 6f 6e | 20 61 20 66 65 77 20 62 | loop on| a few b|
|00003eb0| 79 74 65 73 20 6f 66 20 | 61 20 73 61 6d 70 6c 65 |ytes of |a sample|
|00003ec0| 20 61 6e 64 20 72 65 70 | 72 6f 64 75 63 65 20 74 | and rep|roduce t|
|00003ed0| 68 65 20 73 6f 75 6e 64 | 2c 20 74 68 65 20 53 6f |he sound|, the So|
|00003ee0| 75 6e 64 20 4d 61 6e 61 | 67 65 72 20 68 61 73 20 |und Mana|ger has |
|00003ef0| 74 6f 20 73 70 65 63 69 | 61 6c 20 63 61 73 65 20 |to speci|al case |
|00003f00| 74 68 69 73 20 61 6e 64 | 20 63 6f 6e 73 69 64 65 |this and| conside|
|00003f10| 72 20 74 68 65 20 73 6f | 75 6e 64 20 61 73 20 6e |r the so|und as n|
|00003f20| 6f 74 20 68 61 76 69 6e | 67 20 61 6e 79 20 6c 6f |ot havin|g any lo|
|00003f30| 6f 70 20 70 6f 69 6e 74 | 73 2e 20 20 54 68 69 73 |op point|s. This|
|00003f40| 20 69 73 20 61 6c 6c 20 | 64 75 65 20 74 6f 20 61 | is all |due to a|
|00003f50| 20 62 75 67 20 74 68 61 | 74 20 65 78 69 73 74 65 | bug tha|t existe|
|00003f60| 64 20 69 6e 20 74 68 65 | 20 6f 72 69 67 69 6e 61 |d in the| origina|
|00003f70| 6c 20 53 6f 75 6e 64 20 | 4d 61 6e 61 67 65 72 20 |l Sound |Manager |
|00003f80| 61 6e 64 20 64 65 76 65 | 6c 6f 70 65 72 73 20 64 |and deve|lopers d|
|00003f90| 69 73 63 6f 76 65 72 65 | 64 20 74 68 69 73 20 77 |iscovere|d this w|
|00003fa0| 6f 72 6b 20 61 72 6f 75 | 6e 64 20 28 62 65 63 61 |ork arou|nd (beca|
|00003fb0| 75 73 65 20 73 6f 6d 65 | 6f 6e 65 20 61 74 20 41 |use some|one at A|
|00003fc0| 70 70 6c 65 20 72 65 63 | 6f 6d 6d 65 6e 64 20 74 |pple rec|ommend t|
|00003fd0| 68 69 73 20 61 73 20 61 | 20 d2 73 6f 6c 75 74 69 |his as a| .soluti|
|00003fe0| 6f 6e d3 29 20 61 6e 64 | 20 62 65 63 61 75 73 65 |on.) and| because|
|00003ff0| 20 6f 66 20 74 68 69 73 | 20 77 65 20 68 61 76 65 | of this| we have|
|00004000| 20 74 6f 20 63 6f 6e 74 | 69 6e 75 65 20 73 75 70 | to cont|inue sup|
|00004010| 70 6f 72 74 69 6e 67 20 | 69 74 73 20 62 65 68 61 |porting |its beha|
|00004020| 76 69 6f 72 2e 20 20 48 | 79 70 65 72 43 61 72 64 |vior. H|yperCard|
|00004030| 20 66 6f 72 20 65 78 61 | 6d 70 6c 65 20 72 65 6c | for exa|mple rel|
|00004040| 69 65 73 20 6f 6e 20 74 | 68 69 73 2e 0d 53 79 73 |ies on t|his..Sys|
|00004050| 74 65 6d 20 36 2e 30 2e | 37 0d 49 66 20 61 20 71 |tem 6.0.|7.If a q|
|00004060| 75 69 65 74 43 6d 64 20 | 77 61 73 20 73 65 6e 74 |uietCmd |was sent|
|00004070| 20 75 73 69 6e 67 20 53 | 6e 64 44 6f 49 6d 6d 65 | using S|ndDoImme|
|00004080| 64 69 61 74 65 20 77 68 | 69 6c 65 20 61 20 66 72 |diate wh|ile a fr|
|00004090| 65 71 44 75 72 61 74 69 | 6f 6e 43 6d 64 20 77 61 |eqDurati|onCmd wa|
|000040a0| 73 20 69 6e 20 70 72 6f | 67 72 65 73 73 2c 20 74 |s in pro|gress, t|
|000040b0| 68 65 20 73 6f 75 6e 64 | 20 77 6f 75 6c 64 20 73 |he sound| would s|
|000040c0| 74 6f 70 20 62 75 74 20 | 69 74 d5 73 20 70 65 6e |top but |it.s pen|
|000040d0| 64 69 6e 67 20 64 75 72 | 61 74 69 6f 6e 20 77 6f |ding dur|ation wo|
|000040e0| 75 6c 64 20 6e 6f 74 20 | 62 65 20 72 65 6d 6f 76 |uld not |be remov|
|000040f0| 65 64 2e 20 54 68 69 73 | 20 63 61 75 73 65 73 20 |ed. This| causes |
|00004100| 74 68 65 20 63 68 61 6e | 6e 65 6c 20 74 6f 20 73 |the chan|nel to s|
|00004110| 65 65 6d 20 68 75 6e 67 | 2c 20 62 75 74 20 69 74 |eem hung|, but it|
|00004120| d5 73 20 61 63 74 75 61 | 6c 6c 79 20 77 61 69 74 |.s actua|lly wait|
|00004130| 69 6e 67 20 66 6f 72 20 | 74 68 65 20 64 75 72 61 |ing for |the dura|
|00004140| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 66 72 65 71 |tion of |the freq|
|00004150| 44 75 72 61 74 69 6f 6e | 43 6d 64 20 62 65 66 6f |Duration|Cmd befo|
|00004160| 72 65 20 63 6f 6e 74 69 | 6e 75 69 6e 67 20 74 6f |re conti|nuing to|
|00004170| 20 70 72 6f 63 65 73 73 | 20 63 6f 6d 6d 61 6e 64 | process| command|
|00004180| 73 20 66 72 6f 6d 20 74 | 68 65 20 71 75 65 75 65 |s from t|he queue|
|00004190| 2e 0d 53 79 73 74 65 6d | 20 36 2e 30 2e 37 2d 62 |..System| 6.0.7-b|
|000041a0| 65 79 6f 6e 64 0d 54 68 | 65 20 64 75 72 61 74 69 |eyond.Th|e durati|
|000041b0| 6f 6e 20 69 73 20 63 6f | 6e 73 69 64 65 72 65 64 |on is co|nsidered|
|000041c0| 20 61 6e 20 75 6e 73 69 | 67 6e 65 64 20 73 68 6f | an unsi|gned sho|
|000041d0| 72 74 2c 20 77 68 69 63 | 68 20 61 6c 6c 6f 77 73 |rt, whic|h allows|
|000041e0| 20 66 6f 72 20 74 77 69 | 63 65 20 74 68 65 20 64 | for twi|ce the d|
|000041f0| 75 72 61 74 69 6f 6e 20 | 74 68 61 74 20 77 61 73 |uration |that was|
|00004200| 20 6f 72 69 67 69 6e 61 | 6c 6c 79 20 64 6f 63 75 | origina|lly docu|
|00004210| 6d 65 6e 74 65 64 2e 20 | 20 53 69 6e 63 65 20 74 |mented. | Since t|
|00004220| 68 65 72 65 d5 73 20 6e | 6f 20 73 75 63 68 20 74 |here.s n|o such t|
|00004230| 68 69 6e 67 20 61 73 20 | 61 20 6e 65 67 61 74 69 |hing as |a negati|
|00004240| 76 65 20 64 75 72 61 74 | 69 6f 6e 20 6f 66 20 74 |ve durat|ion of t|
|00004250| 69 6d 65 2c 20 77 65 20 | 63 68 61 6e 67 65 20 70 |ime, we |change p|
|00004260| 61 72 61 6d 31 20 74 6f | 20 62 65 20 75 6e 73 69 |aram1 to| be unsi|
|00004270| 67 6e 65 64 20 61 6e 64 | 20 74 68 69 73 20 73 75 |gned and| this su|
|00004280| 70 70 6f 72 74 73 20 75 | 70 20 74 6f 20 33 32 20 |pports u|p to 32 |
|00004290| 73 65 63 6f 6e 64 73 20 | 6f 66 20 64 75 72 61 74 |seconds |of durat|
|000042a0| 69 6f 6e 2e 20 20 50 72 | 65 76 69 6f 75 73 6c 79 |ion. Pr|eviously|
|000042b0| 20 69 74 20 77 61 73 20 | 6c 69 6d 69 74 65 64 20 | it was |limited |
|000042c0| 74 6f 20 31 36 20 73 65 | 63 6f 6e 64 73 2e 20 20 |to 16 se|conds. |
|000042d0| 49 66 20 79 6f 75 20 64 | 6f 20 73 65 6e 64 20 61 |If you d|o send a|
|000042e0| 20 76 61 6c 75 65 20 67 | 72 65 61 74 65 72 20 74 | value g|reater t|
|000042f0| 68 61 74 20 33 32 2c 37 | 36 37 20 28 30 78 37 46 |hat 32,7|67 (0x7F|
|00004300| 46 46 29 20 74 6f 20 74 | 68 65 20 6f 6c 64 65 72 |FF) to t|he older|
|00004310| 20 53 6f 75 6e 64 20 4d | 61 6e 61 67 65 72 20 74 | Sound M|anager t|
|00004320| 68 65 20 72 65 73 75 6c | 74 73 20 61 72 65 20 75 |he resul|ts are u|
|00004330| 6e 64 65 66 69 6e 65 64 | 2e 20 20 49 20 77 6f 75 |ndefined|. I wou|
|00004340| 6c 64 20 67 75 65 73 73 | 20 74 68 61 74 20 74 68 |ld guess| that th|
|00004350| 65 20 63 6f 6d 6d 61 6e | 64 20 77 6f 75 6c 64 20 |e comman|d would |
|00004360| 66 61 69 6c 2e 0d 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |fail..__|________|
|00004370| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004380| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 67 65 74 41 6d |________|__.getAm|
|00004390| 70 43 6d 64 0d 70 61 72 | 61 6d 31 09 30 20 28 69 |pCmd.par|am1.0 (i|
|000043a0| 67 6e 6f 72 65 64 20 6f | 6e 20 69 6e 70 75 74 20 |gnored o|n input |
|000043b0| 61 6e 64 20 6f 75 74 70 | 75 74 29 0d 70 61 72 61 |and outp|ut).para|
|000043c0| 6d 32 09 70 6f 69 6e 74 | 65 72 20 74 6f 20 61 6d |m2.point|er to am|
|000043d0| 70 6c 69 74 75 64 65 20 | 76 61 72 69 61 62 6c 65 |plitude |variable|
|000043e0| 0d 44 65 74 65 72 6d 69 | 6e 65 73 20 74 68 65 20 |.Determi|nes the |
|000043f0| 63 75 72 72 65 6e 74 20 | 61 6d 70 6c 69 74 75 64 |current |amplitud|
|00004400| 65 20 28 6f 72 20 6c 6f | 75 64 6e 65 73 73 29 20 |e (or lo|udness) |
|00004410| 6f 66 20 61 20 73 6f 75 | 6e 64 2e 20 54 68 65 20 |of a sou|nd. The |
|00004420| 61 6d 70 6c 69 74 75 64 | 65 20 69 73 20 72 65 74 |amplitud|e is ret|
|00004430| 75 72 6e 65 64 20 69 6e | 20 61 6e 20 69 6e 74 65 |urned in| an inte|
|00004440| 67 65 72 20 76 61 72 69 | 61 62 6c 65 20 77 68 6f |ger vari|able who|
|00004450| 73 65 20 61 64 64 72 65 | 73 73 20 79 6f 75 20 70 |se addre|ss you p|
|00004460| 61 73 73 20 69 6e 20 70 | 61 72 61 6d 32 20 61 6e |ass in p|aram2 an|
|00004470| 64 20 69 73 20 69 6e 20 | 74 68 65 20 72 61 6e 67 |d is in |the rang|
|00004480| 65 20 30 20 74 6f 20 32 | 35 35 2e 20 59 6f 75 20 |e 0 to 2|55. You |
|00004490| 63 61 6e 20 73 65 6e 64 | 20 67 65 74 41 6d 70 43 |can send| getAmpC|
|000044a0| 6d 64 20 74 6f 20 61 6e | 79 20 6f 66 20 74 68 65 |md to an|y of the|
|000044b0| 20 61 76 61 69 6c 61 62 | 6c 65 20 73 79 6e 74 68 | availab|le synth|
|000044c0| 65 73 69 7a 65 72 73 2e | 0d 4e 6f 74 65 73 0d 4f |esizers.|.Notes.O|
|000044d0| 6e 6c 79 20 73 75 70 70 | 6f 72 74 65 64 20 62 79 |nly supp|orted by|
|000044e0| 20 74 68 65 20 73 61 6d | 70 6c 65 64 53 6f 75 6e | the sam|pledSoun|
|000044f0| 64 53 79 6e 74 68 20 6f | 6e 20 41 70 70 6c 65 20 |dSynth o|n Apple |
|00004500| 53 6f 75 6e 64 20 43 68 | 69 70 20 6d 61 63 68 69 |Sound Ch|ip machi|
|00004510| 6e 65 73 2e 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |nes..___|________|
|00004520| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004530| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 67 65 74 52 61 74 |________|_.getRat|
|00004540| 65 43 6d 64 0d 70 61 72 | 61 6d 31 09 30 20 28 69 |eCmd.par|am1.0 (i|
|00004550| 67 6e 6f 72 65 64 20 6f | 6e 20 69 6e 70 75 74 20 |gnored o|n input |
|00004560| 61 6e 64 20 6f 75 74 70 | 75 74 29 0d 70 61 72 61 |and outp|ut).para|
|00004570| 6d 32 09 70 6f 69 6e 74 | 65 72 20 74 6f 20 72 61 |m2.point|er to ra|
|00004580| 74 65 20 76 61 72 69 61 | 62 6c 65 0d 44 65 74 65 |te varia|ble.Dete|
|00004590| 72 6d 69 6e 65 73 20 74 | 68 65 20 73 61 6d 70 6c |rmines t|he sampl|
|000045a0| 65 20 72 61 74 65 20 6f | 66 20 74 68 65 20 73 61 |e rate o|f the sa|
|000045b0| 6d 70 6c 65 64 20 73 6f | 75 6e 64 20 63 75 72 72 |mpled so|und curr|
|000045c0| 65 6e 74 6c 79 20 70 6c | 61 79 69 6e 67 2e 20 54 |ently pl|aying. T|
|000045d0| 68 65 20 63 75 72 72 65 | 6e 74 20 72 61 74 65 20 |he curre|nt rate |
|000045e0| 6f 66 20 74 68 65 20 63 | 68 61 6e 6e 65 6c 20 69 |of the c|hannel i|
|000045f0| 73 20 72 65 74 75 72 6e | 65 64 20 69 6e 20 61 20 |s return|ed in a |
|00004600| 46 69 78 65 64 20 76 61 | 72 69 61 62 6c 65 20 77 |Fixed va|riable w|
|00004610| 68 6f 73 65 20 61 64 64 | 72 65 73 73 20 79 6f 75 |hose add|ress you|
|00004620| 20 70 61 73 73 20 69 6e | 20 70 61 72 61 6d 32 20 | pass in| param2 |
|00004630| 6f 66 20 74 68 65 20 73 | 6f 75 6e 64 20 63 6f 6d |of the s|ound com|
|00004640| 6d 61 6e 64 2e 20 59 6f | 75 20 63 61 6e 20 73 65 |mand. Yo|u can se|
|00004650| 6e 64 20 67 65 74 52 61 | 74 65 43 6d 64 20 6f 6e |nd getRa|teCmd on|
|00004660| 6c 79 20 74 6f 20 74 68 | 65 20 73 61 6d 70 6c 65 |ly to th|e sample|
|00004670| 64 20 73 6f 75 6e 64 20 | 73 79 6e 74 68 65 73 69 |d sound |synthesi|
|00004680| 7a 65 72 2c 20 62 75 74 | 20 79 6f 75 20 73 68 6f |zer, but| you sho|
|00004690| 75 6c 64 20 73 65 6e 64 | 20 69 74 20 62 79 20 75 |uld send| it by u|
|000046a0| 73 69 6e 67 20 53 6e 64 | 44 6f 49 6d 6d 65 64 69 |sing Snd|DoImmedi|
|000046b0| 61 74 65 2e 0d 4e 6f 74 | 65 73 0d 4f 6e 6c 79 20 |ate..Not|es.Only |
|000046c0| 73 75 70 70 6f 72 74 65 | 64 20 62 79 20 74 68 65 |supporte|d by the|
|000046d0| 20 73 61 6d 70 6c 65 64 | 53 6f 75 6e 64 53 79 6e | sampled|SoundSyn|
|000046e0| 74 68 20 6f 6e 20 41 70 | 70 6c 65 20 53 6f 75 6e |th on Ap|ple Soun|
|000046f0| 64 20 43 68 69 70 20 6d | 61 63 68 69 6e 65 73 2e |d Chip m|achines.|
|00004700| 0d 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |._______|________|
|00004710| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004720| 5f 5f 5f 5f 5f 0d 68 6f | 77 4f 66 74 65 6e 43 6d |_____.ho|wOftenCm|
|00004730| 64 0d 54 68 69 73 20 63 | 6f 6d 6d 61 6e 64 20 69 |d.This c|ommand i|
|00004740| 73 20 73 65 6e 74 20 62 | 79 20 61 20 6d 6f 64 69 |s sent b|y a modi|
|00004750| 66 69 65 72 20 61 6e 64 | 20 77 69 6c 6c 20 69 6e |fier and| will in|
|00004760| 73 74 72 75 63 74 20 74 | 68 65 20 53 6f 75 6e 64 |struct t|he Sound|
|00004770| 20 4d 61 6e 61 67 65 72 | 20 74 6f 20 70 65 72 69 | Manager| to peri|
|00004780| 6f 64 69 63 61 6c 6c 79 | 20 73 65 6e 64 20 61 20 |odically| send a |
|00004790| 74 69 63 6b 6c 65 43 6d | 64 2e 20 20 50 61 72 61 |tickleCm|d. Para|
|000047a0| 6d 31 20 63 6f 6e 74 61 | 69 6e 73 20 74 68 65 20 |m1 conta|ins the |
|000047b0| 70 65 72 69 6f 64 20 28 | 69 6e 20 68 61 6c 66 2d |period (|in half-|
|000047c0| 6d 69 6c 6c 69 73 65 63 | 6f 6e 64 73 29 20 74 68 |millisec|onds) th|
|000047d0| 61 74 20 61 20 74 69 63 | 6b 6c 65 43 6d 64 20 73 |at a tic|kleCmd s|
|000047e0| 68 6f 75 6c 64 20 62 65 | 20 73 65 6e 74 2e 20 20 |hould be| sent. |
|000047f0| 50 61 72 61 6d 32 20 63 | 6f 6e 74 61 69 6e 73 20 |Param2 c|ontains |
|00004800| 61 20 50 4f 49 4e 54 45 | 52 20 74 6f 20 74 68 65 |a POINTE|R to the|
|00004810| 20 6d 6f 64 69 66 69 65 | 72 20 73 74 75 62 2e 20 | modifie|r stub. |
|00004820| 20 54 68 65 20 68 6f 77 | 4f 66 74 65 6e 43 6d 64 | The how|OftenCmd|
|00004830| 20 61 6e 64 20 74 68 65 | 20 77 61 6b 65 55 70 43 | and the| wakeUpC|
|00004840| 6d 64 20 61 72 65 20 6d | 75 74 75 61 6c 6c 79 20 |md are m|utually |
|00004850| 65 78 63 6c 75 73 69 76 | 65 2e 20 20 53 65 6e 64 |exclusiv|e. Send|
|00004860| 69 6e 67 20 6f 6e 65 20 | 77 69 6c 6c 20 63 61 6e |ing one |will can|
|00004870| 63 65 6c 20 74 68 65 20 | 6f 74 68 65 72 2e 0d 4e |cel the |other..N|
|00004880| 6f 74 65 73 0d 41 70 70 | 6c 69 63 61 74 69 6f 6e |otes.App|lication|
|00004890| 73 20 73 68 6f 75 6c 64 | 20 6e 65 76 65 72 20 75 |s should| never u|
|000048a0| 73 65 20 74 68 69 73 20 | 63 6f 6d 6d 61 6e 64 2e |se this |command.|
|000048b0| 20 20 49 74 20 69 73 20 | 61 6e 20 69 6e 74 65 72 | It is |an inter|
|000048c0| 6e 61 6c 20 63 6f 6d 6d | 61 6e 64 20 66 6f 72 20 |nal comm|and for |
|000048d0| 74 68 65 20 53 6f 75 6e | 64 20 4d 61 6e 61 67 65 |the Soun|d Manage|
|000048e0| 72 2e 0d 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |r.._____|________|
|000048f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004900| 5f 5f 5f 5f 5f 5f 5f 0d | 69 6e 69 74 43 6d 64 0d |_______.|initCmd.|
|00004910| 54 68 69 73 20 63 6f 6d | 6d 61 6e 64 20 69 73 20 |This com|mand is |
|00004920| 6f 6e 6c 79 20 73 65 6e | 74 20 62 79 20 74 68 65 |only sen|t by the|
|00004930| 20 53 6f 75 6e 64 20 4d | 61 6e 61 67 65 72 2e 20 | Sound M|anager. |
|00004940| 20 49 74 20 77 69 6c 6c | 20 73 65 6e 64 20 61 6e | It will| send an|
|00004950| 20 69 6e 69 74 43 6d 64 | 20 74 6f 20 74 68 65 20 | initCmd| to the |
|00004960| 73 79 6e 74 68 65 73 69 | 7a 65 72 20 77 68 65 6e |synthesi|zer when|
|00004970| 20 61 6e 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 | an appl|ication |
|00004980| 75 73 65 73 20 74 68 65 | 20 72 6f 75 74 69 6e 65 |uses the| routine|
|00004990| 73 20 53 6e 64 50 6c 61 | 79 2c 20 53 6e 64 4e 65 |s SndPla|y, SndNe|
|000049a0| 77 43 68 61 6e 6e 65 6c | 20 6f 72 20 53 6e 64 41 |wChannel| or SndA|
|000049b0| 64 64 4d 6f 64 69 66 69 | 65 72 2e 20 20 54 68 69 |ddModifi|er. Thi|
|000049c0| 73 20 63 61 75 73 65 73 | 20 61 20 73 79 6e 74 68 |s causes| a synth|
|000049d0| 65 73 69 7a 65 72 20 6f | 72 20 6d 6f 64 69 66 69 |esizer o|r modifi|
|000049e0| 65 72 20 74 6f 20 61 6c | 6c 6f 63 61 74 65 20 69 |er to al|locate i|
|000049f0| 74 73 20 70 72 69 76 61 | 74 65 20 6d 65 6d 6f 72 |ts priva|te memor|
|00004a00| 79 20 73 74 6f 72 61 67 | 65 20 61 6e 64 20 74 6f |y storag|e and to|
|00004a10| 20 75 73 65 20 74 68 65 | 20 69 6e 69 74 20 6f 70 | use the| init op|
|00004a20| 74 69 6f 6e 2e 0d 4e 6f | 74 65 73 0d 41 70 70 6c |tion..No|tes.Appl|
|00004a30| 69 63 61 74 69 6f 6e 73 | 20 73 68 6f 75 6c 64 20 |ications| should |
|00004a40| 6e 65 76 65 72 20 75 73 | 65 20 74 68 69 73 20 63 |never us|e this c|
|00004a50| 6f 6d 6d 61 6e 64 2e 20 | 20 49 74 20 69 73 20 61 |ommand. | It is a|
|00004a60| 6e 20 69 6e 74 65 72 6e | 61 6c 20 63 6f 6d 6d 61 |n intern|al comma|
|00004a70| 6e 64 20 66 6f 72 20 74 | 68 65 20 53 6f 75 6e 64 |nd for t|he Sound|
|00004a80| 20 4d 61 6e 61 67 65 72 | 2e 0d 53 79 73 74 65 6d | Manager|..System|
|00004a90| 20 70 72 65 2d 36 2e 30 | 2e 37 0d 54 68 65 20 69 | pre-6.0|.7.The i|
|00004aa0| 6e 69 74 20 6f 70 74 69 | 6f 6e 73 20 77 65 72 65 |nit opti|ons were|
|00004ab0| 20 6d 65 61 6e 69 6e 67 | 6c 65 73 73 2e 20 20 54 | meaning|less. T|
|00004ac0| 68 65 79 20 64 69 64 6e | d5 74 20 61 63 74 75 61 |hey didn|.t actua|
|00004ad0| 6c 6c 79 20 63 68 61 6e | 67 65 20 74 68 65 20 62 |lly chan|ge the b|
|00004ae0| 65 68 61 76 69 6f 75 72 | 20 6f 66 20 61 20 63 68 |ehaviour| of a ch|
|00004af0| 61 6e 6e 65 6c 20 65 78 | 63 65 70 74 20 66 6f 72 |annel ex|cept for|
|00004b00| 20 74 68 65 20 63 72 65 | 61 74 69 6f 6e 20 6f 66 | the cre|ation of|
|00004b10| 20 74 68 65 20 77 61 76 | 65 54 61 62 6c 65 53 6e | the wav|eTableSn|
|00004b20| 74 68 20 63 68 61 6e 6e | 65 6c 73 2e 20 20 54 68 |th chann|els. Th|
|00004b30| 65 20 6f 70 74 69 6f 6e | 73 20 77 65 72 65 20 76 |e option|s were v|
|00004b40| 65 72 79 20 63 6f 6e 66 | 75 73 69 6e 67 20 61 6e |ery conf|using an|
|00004b50| 64 20 69 74 20 77 61 73 | 6e d5 74 20 64 6f 63 75 |d it was|n.t docu|
|00004b60| 6d 65 6e 74 65 64 20 61 | 73 20 74 6f 20 68 6f 77 |mented a|s to how|
|00004b70| 20 74 6f 20 73 65 74 20 | 74 68 65 6d 2e 20 20 49 | to set |them. I|
|00004b80| 20 73 75 73 70 65 63 74 | 20 74 68 61 74 20 64 65 | suspect| that de|
|00004b90| 76 65 6c 6f 70 65 72 73 | 20 61 72 65 20 63 6f 6d |velopers| are com|
|00004ba0| 6d 6f 6e 6c 79 20 75 73 | 69 6e 67 20 74 68 65 20 |monly us|ing the |
|00004bb0| 77 72 6f 6e 67 20 69 6e | 69 74 20 6f 70 74 69 6f |wrong in|it optio|
|00004bc0| 6e 73 2e 20 20 54 68 65 | 79 20 61 72 65 20 73 75 |ns. The|y are su|
|00004bd0| 70 70 6f 73 65 20 74 6f | 20 62 65 20 61 20 73 65 |ppose to| be a se|
|00004be0| 74 20 6f 66 20 62 69 74 | 20 66 6c 61 67 73 2e 20 |t of bit| flags. |
|00004bf0| 20 53 65 74 74 69 6e 67 | 20 61 20 73 70 65 63 69 | Setting| a speci|
|00004c00| 66 69 63 20 62 69 74 20 | 6d 65 61 6e 73 20 74 6f |fic bit |means to|
|00004c10| 20 74 75 72 6e 20 6f 6e | 20 61 20 73 70 65 63 69 | turn on| a speci|
|00004c20| 66 69 63 20 6f 70 74 69 | 6f 6e 2e 20 20 57 68 65 |fic opti|on. Whe|
|00004c30| 6e 20 77 65 20 77 65 72 | 65 20 77 6f 72 6b 69 6e |n we wer|e workin|
|00004c40| 67 20 6f 6e 20 74 68 65 | 20 53 79 73 74 65 6d 20 |g on the| System |
|00004c50| 37 2e 30 20 69 6e 74 65 | 72 66 61 63 65 73 20 66 |7.0 inte|rfaces f|
|00004c60| 6f 72 20 4d 50 57 20 77 | 65 20 72 65 6d 6f 76 65 |or MPW w|e remove|
|00004c70| 64 20 61 6c 6c 20 6f 66 | 20 74 68 65 20 6f 6c 64 |d all of| the old|
|00004c80| 20 61 6e 64 20 73 74 75 | 70 69 64 20 66 6c 61 67 | and stu|pid flag|
|00004c90| 73 20 61 6e 64 20 63 6f | 72 72 65 63 74 65 64 20 |s and co|rrected |
|00004ca0| 74 68 65 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |the docu|mentatio|
|00004cb0| 6e 2e 0d 53 79 73 74 65 | 6d 20 36 2e 30 2e 37 2d |n..Syste|m 6.0.7-|
|00004cc0| 37 2e 30 0d 4d 6f 73 74 | 20 6f 66 20 74 68 65 20 |7.0.Most| of the |
|00004cd0| 69 6e 69 74 20 6f 70 74 | 69 6f 6e 73 20 63 6f 6e |init opt|ions con|
|00004ce0| 74 69 6e 75 65 20 74 6f | 20 62 65 20 6d 65 61 6e |tinue to| be mean|
|00004cf0| 69 6e 67 6c 65 73 73 2e | 20 20 4f 6e 6c 79 20 61 |ingless.| Only a|
|00004d00| 20 62 75 6e 63 68 20 6d | 6f 72 65 20 77 65 72 65 | bunch m|ore were|
|00004d10| 20 64 65 66 69 6e 65 64 | 2e 20 20 54 68 65 73 65 | defined|. These|
|00004d20| 20 68 61 76 65 20 6e 6f | 20 61 66 66 65 63 74 20 | have no| affect |
|00004d30| 62 75 74 20 74 68 65 79 | 20 64 6f 20 63 68 61 6e |but they| do chan|
|00004d40| 67 65 20 74 68 65 20 72 | 65 73 75 6c 74 73 20 6f |ge the r|esults o|
|00004d50| 66 20 74 68 65 20 53 6f | 75 6e 64 20 4d 61 6e 61 |f the So|und Mana|
|00004d60| 67 65 72 20 61 74 74 65 | 6d 70 74 69 6e 67 20 74 |ger atte|mpting t|
|00004d70| 6f 20 63 61 6c 63 75 6c | 61 74 65 20 74 68 65 20 |o calcul|ate the |
|00004d80| 43 50 55 20 6c 6f 61 64 | 69 6e 67 20 66 61 63 74 |CPU load|ing fact|
|00004d90| 6f 72 20 66 6f 72 20 74 | 68 61 74 20 63 68 61 6e |or for t|hat chan|
|00004da0| 6e 65 6c 2e 20 20 52 65 | 61 64 20 61 62 6f 75 74 |nel. Re|ad about|
|00004db0| 20 74 68 65 20 6c 6f 61 | 64 43 6d 64 20 61 6e 64 | the loa|dCmd and|
|00004dc0| 20 74 6f 74 61 6c 4c 6f | 61 64 43 6d 64 20 66 6f | totalLo|adCmd fo|
|00004dd0| 72 20 6d 6f 72 65 20 64 | 65 74 61 69 6c 73 2e 20 |r more d|etails. |
|00004de0| 20 46 75 72 74 68 65 72 | 6d 6f 72 65 2c 20 69 66 | Further|more, if|
|00004df0| 20 79 6f 75 20 6f 70 65 | 6e 20 61 20 63 68 61 6e | you ope|n a chan|
|00004e00| 6e 65 6c 20 66 6f 72 20 | 73 74 65 72 65 6f 20 69 |nel for |stereo i|
|00004e10| 74 20 77 69 6c 6c 20 6e | 6f 74 20 70 6c 61 79 20 |t will n|ot play |
|00004e20| 79 6f 75 72 20 73 6f 75 | 6e 64 73 20 69 6e 20 73 |your sou|nds in s|
|00004e30| 74 65 72 65 6f 20 75 6e | 6c 65 73 73 20 79 6f 75 |tereo un|less you|
|00004e40| 20 68 61 76 65 20 61 20 | 73 74 65 72 65 6f 20 73 | have a |stereo s|
|00004e50| 6f 75 6e 64 2e 20 20 41 | 6e 64 20 69 66 20 79 6f |ound. A|nd if yo|
|00004e60| 75 20 6f 70 65 6e 20 61 | 20 63 68 61 6e 6e 65 6c |u open a| channel|
|00004e70| 20 66 6f 72 20 6d 6f 6e | 6f 20 61 6e 64 20 73 65 | for mon|o and se|
|00004e80| 6e 64 20 69 74 20 61 20 | 73 74 65 72 65 6f 20 73 |nd it a |stereo s|
|00004e90| 6f 75 6e 64 20 69 74 20 | 77 69 6c 6c 20 70 6c 61 |ound it |will pla|
|00004ea0| 79 20 74 68 65 20 73 6f | 75 6e 64 20 69 6e 20 73 |y the so|und in s|
|00004eb0| 74 65 72 65 6f 2e 20 20 | 54 68 65 20 74 72 75 74 |tereo. |The trut|
|00004ec0| 68 20 69 73 20 77 68 61 | 74 20 72 65 61 6c 6c 79 |h is wha|t really|
|00004ed0| 20 63 6f 6e 74 72 6f 6c | 73 20 74 68 65 20 73 6f | control|s the so|
|00004ee0| 75 6e 64 20 69 73 20 74 | 68 65 20 73 6f 75 6e 64 |und is t|he sound|
|00004ef0| 20 68 65 61 64 65 72 2c | 20 6e 6f 74 20 74 68 65 | header,| not the|
|00004f00| 20 63 68 61 6e 6e 65 6c | d5 73 20 69 6e 69 74 20 | channel|.s init |
|00004f10| 6f 70 74 69 6f 6e 73 2e | 20 20 54 68 65 20 6f 6e |options.| The on|
|00004f20| 6c 79 20 66 6c 61 67 20 | 74 68 61 74 20 72 65 61 |ly flag |that rea|
|00004f30| 6c 6c 79 20 6d 61 6b 65 | 73 20 61 6e 79 20 64 69 |lly make|s any di|
|00004f40| 66 66 65 72 65 6e 63 65 | 20 69 73 20 74 68 65 20 |fference| is the |
|00004f50| 69 6e 69 74 4e 6f 49 6e | 74 65 72 70 2e 20 20 54 |initNoIn|terp. T|
|00004f60| 68 69 73 20 77 69 6c 6c | 20 74 75 72 6e 20 6f 66 |his will| turn of|
|00004f70| 66 20 69 6e 74 65 72 70 | 6f 6c 61 74 69 6f 6e 20 |f interp|olation |
|00004f80| 77 68 69 63 68 20 6d 61 | 6b 65 73 20 73 61 6d 70 |which ma|kes samp|
|00004f90| 6c 65 20 72 61 74 65 20 | 63 6f 6e 76 65 72 73 69 |le rate |conversi|
|00004fa0| 6f 6e 20 66 61 73 74 65 | 72 20 62 75 74 20 72 65 |on faste|r but re|
|00004fb0| 64 75 63 65 73 20 74 68 | 65 20 71 75 61 6c 69 74 |duces th|e qualit|
|00004fc0| 79 20 6f 66 20 74 68 65 | 20 73 6f 75 6e 64 2e 0d |y of the| sound..|
|00004fd0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004fe0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004ff0| 5f 5f 5f 5f 0d 6c 6f 61 | 64 43 6d 64 0d 70 61 72 |____.loa|dCmd.par|
|00005000| 61 6d 31 09 30 20 6f 6e | 20 69 6e 70 75 74 2c 20 |am1.0 on| input, |
|00005010| 6c 6f 61 64 20 66 61 63 | 74 6f 72 20 6f 6e 20 6f |load fac|tor on o|
|00005020| 75 74 70 75 74 0d 70 61 | 72 61 6d 32 09 69 6e 69 |utput.pa|ram2.ini|
|00005030| 74 69 61 6c 69 7a 61 74 | 69 6f 6e 20 6f 70 74 69 |tializat|ion opti|
|00005040| 6f 6e 73 0d 44 65 74 65 | 72 6d 69 6e 65 73 20 74 |ons.Dete|rmines t|
|00005050| 68 65 20 43 50 55 20 6c | 6f 61 64 20 66 61 63 74 |he CPU l|oad fact|
|00005060| 6f 72 20 74 68 61 74 20 | 77 6f 75 6c 64 20 62 65 |or that |would be|
|00005070| 20 69 6e 63 75 72 72 65 | 64 20 62 79 20 61 20 6e | incurre|d by a n|
|00005080| 65 77 20 63 68 61 6e 6e | 65 6c 20 6f 66 20 73 6f |ew chann|el of so|
|00005090| 75 6e 64 20 68 61 76 69 | 6e 67 20 74 68 65 20 69 |und havi|ng the i|
|000050a0| 6e 69 74 69 61 6c 69 7a | 61 74 69 6f 6e 20 70 61 |nitializ|ation pa|
|000050b0| 72 61 6d 65 74 65 72 73 | 20 73 70 65 63 69 66 69 |rameters| specifi|
|000050c0| 65 64 20 69 6e 20 70 61 | 72 61 6d 32 2e 20 54 68 |ed in pa|ram2. Th|
|000050d0| 65 20 6c 6f 61 64 20 66 | 61 63 74 6f 72 20 69 73 |e load f|actor is|
|000050e0| 20 74 68 65 20 70 65 72 | 63 65 6e 74 61 67 65 20 | the per|centage |
|000050f0| 6f 66 20 43 50 55 20 70 | 72 6f 63 65 73 73 69 6e |of CPU p|rocessin|
|00005100| 67 20 70 6f 77 65 72 20 | 74 68 61 74 20 74 68 65 |g power |that the|
|00005110| 20 73 70 65 63 69 66 69 | 65 64 20 73 6f 75 6e 64 | specifi|ed sound|
|00005120| 20 63 68 61 6e 6e 65 6c | 20 77 6f 75 6c 64 20 72 | channel| would r|
|00005130| 65 71 75 69 72 65 2e 20 | 59 6f 75 20 63 61 6e 20 |equire. |You can |
|00005140| 73 65 6e 64 20 6c 6f 61 | 64 43 6d 64 20 74 6f 20 |send loa|dCmd to |
|00005150| 61 6e 79 20 6f 66 20 74 | 68 65 20 61 76 61 69 6c |any of t|he avail|
|00005160| 61 62 6c 65 20 73 79 6e | 74 68 65 73 69 7a 65 72 |able syn|thesizer|
|00005170| 73 2e 20 59 6f 75 20 6d | 75 73 74 20 73 65 6e 64 |s. You m|ust send|
|00005180| 20 6c 6f 61 64 43 6d 64 | 20 75 73 69 6e 67 20 53 | loadCmd| using S|
|00005190| 6e 64 43 6f 6e 74 72 6f | 6c 2e 0d 53 79 73 74 65 |ndContro|l..Syste|
|000051a0| 6d 20 36 2e 30 2e 37 2d | 70 72 65 73 65 6e 74 0d |m 6.0.7-|present.|
|000051b0| 54 68 69 73 20 69 73 6e | d5 74 20 61 6e 20 61 63 |This isn|.t an ac|
|000051c0| 63 72 75 61 74 65 20 6d | 65 61 73 75 72 65 20 6f |cruate m|easure o|
|000051d0| 66 20 77 68 61 74 20 74 | 68 65 20 74 72 75 65 20 |f what t|he true |
|000051e0| 43 50 55 20 6c 6f 61 64 | 69 6e 67 20 61 63 74 75 |CPU load|ing actu|
|000051f0| 61 6c 6c 79 20 69 73 2e | 20 20 54 68 65 20 63 61 |ally is.| The ca|
|00005200| 6c 63 75 61 74 69 6f 6e | 20 69 73 20 62 61 73 65 |lcuation| is base|
|00005210| 64 20 75 70 6f 6e 20 74 | 68 65 20 70 65 72 66 6f |d upon t|he perfo|
|00005220| 72 6d 61 63 65 20 6f 66 | 20 61 20 4d 61 63 20 49 |rmace of| a Mac I|
|00005230| 49 20 72 75 6e 6e 69 6e | 67 20 61 20 73 65 74 20 |I runnin|g a set |
|00005240| 6f 66 20 73 6f 75 6e 64 | 73 20 28 65 2e 67 2e 20 |of sound|s (e.g. |
|00005250| 6d 6f 6e 6f 2c 20 73 74 | 65 72 65 6f 2c 20 4d 41 |mono, st|ereo, MA|
|00005260| 43 45 2c 20 73 61 6d 70 | 6c 65 20 72 61 74 65 20 |CE, samp|le rate |
|00005270| 63 6f 6e 76 65 72 73 69 | 6f 6e 29 2e 20 20 54 68 |conversi|on). Th|
|00005280| 65 6e 20 69 66 20 79 6f | 75 20 61 64 64 20 61 20 |en if yo|u add a |
|00005290| 6e 65 77 20 63 68 61 6e | 6e 65 6c 20 69 74 20 63 |new chan|nel it c|
|000052a0| 6f 6e 73 69 64 65 72 73 | 20 68 6f 77 20 6d 75 63 |onsiders| how muc|
|000052b0| 68 20 6d 6f 72 65 20 61 | 64 64 69 74 69 6f 6e 61 |h more a|dditiona|
|000052c0| 6c 20 74 69 6d 65 20 69 | 73 20 74 61 6b 65 6e 20 |l time i|s taken |
|000052d0| 74 6f 20 6d 69 78 20 61 | 20 6e 65 77 20 73 6f 75 |to mix a| new sou|
|000052e0| 6e 64 2e 20 20 41 6c 6c | 20 6f 66 20 74 68 65 73 |nd. All| of thes|
|000052f0| 65 20 6e 75 6d 62 65 72 | 73 20 61 72 65 20 6b 65 |e number|s are ke|
|00005300| 70 74 20 69 6e 20 61 20 | 72 65 73 6f 75 72 63 65 |pt in a |resource|
|00005310| 20 61 73 20 61 20 74 61 | 62 6c 65 2e 20 20 54 6f | as a ta|ble. To|
|00005320| 20 64 65 74 65 72 6d 69 | 6e 65 20 74 68 65 20 6c | determi|ne the l|
|00005330| 6f 61 64 69 6e 67 20 66 | 61 63 74 6f 72 20 6f 66 |oading f|actor of|
|00005340| 20 61 20 6d 61 63 68 69 | 6e 65 2c 20 69 74 20 61 | a machi|ne, it a|
|00005350| 74 74 65 6d 70 74 73 20 | 74 6f 20 6e 6f 72 6d 61 |ttempts |to norma|
|00005360| 6c 69 7a 65 20 74 68 65 | 20 6e 75 6d 62 65 72 73 |lize the| numbers|
|00005370| 20 61 63 63 6f 72 64 69 | 6e 67 20 74 6f 20 54 69 | accordi|ng to Ti|
|00005380| 6d 65 44 42 52 41 2e 20 | 20 54 68 65 20 70 72 6f |meDBRA. | The pro|
|00005390| 62 6c 65 6d 20 68 65 72 | 65 20 69 73 20 74 68 61 |blem her|e is tha|
|000053a0| 74 20 74 68 69 73 20 76 | 61 72 69 61 62 6c 65 20 |t this v|ariable |
|000053b0| 69 73 20 6e 6f 74 20 61 | 6e 20 61 63 63 75 72 61 |is not a|n accura|
|000053c0| 74 65 20 69 6e 64 69 63 | 61 74 69 6f 6e 20 6f 66 |te indic|ation of|
|000053d0| 20 74 68 65 20 73 70 65 | 65 64 20 6f 66 20 61 20 | the spe|ed of a |
|000053e0| 6d 61 63 68 69 6e 65 2e | 20 20 54 69 6d 65 44 42 |machine.| TimeDB|
|000053f0| 52 41 20 69 73 20 74 68 | 65 20 6e 75 6d 62 65 72 |RA is th|e number|
|00005400| 20 6f 66 20 44 42 52 41 | 20 69 6e 73 74 72 75 63 | of DBRA| instruc|
|00005410| 74 69 6f 6e 73 20 65 78 | 65 63 75 74 65 64 20 6f |tions ex|ecuted o|
|00005420| 75 74 20 6f 66 20 52 4f | 4d 2c 20 77 68 69 63 68 |ut of RO|M, which|
|00005430| 20 69 6d 70 6c 69 65 73 | 20 61 20 63 61 63 68 65 | implies| a cache|
|00005440| 20 73 69 6e 63 65 20 74 | 68 65 20 72 6f 75 74 69 | since t|he routi|
|00005450| 6e 65 20 74 68 61 74 20 | 73 65 74 73 20 74 68 69 |ne that |sets thi|
|00005460| 73 20 6c 6f 77 20 6d 65 | 6d 6f 72 79 20 67 6c 6f |s low me|mory glo|
|00005470| 62 61 6c 20 69 73 20 61 | 20 73 69 6e 67 6c 65 20 |bal is a| single |
|00005480| 69 6e 73 74 72 75 63 74 | 69 6f 6e 20 6c 6f 6f 70 |instruct|ion loop|
|00005490| 2e 20 20 49 6e 20 66 61 | 63 74 20 74 68 65 20 6e |. In fa|ct the n|
|000054a0| 75 6d 62 65 72 20 69 73 | 20 61 20 68 61 72 64 20 |umber is| a hard |
|000054b0| 63 6f 64 65 64 20 63 6f | 6e 73 74 61 6e 74 20 66 |coded co|nstant f|
|000054c0| 6f 72 20 74 68 65 20 36 | 38 30 34 30 20 6d 61 63 |or the 6|8040 mac|
|000054d0| 68 69 6e 65 73 20 77 68 | 69 63 68 20 77 69 6c 6c |hines wh|ich will|
|000054e0| 20 63 68 61 6e 67 65 64 | 20 62 61 73 65 64 20 75 | changed| based u|
|000054f0| 70 6f 6e 20 74 68 65 20 | 73 65 74 74 69 6e 67 20 |pon the |setting |
|00005500| 6f 66 20 74 68 65 20 63 | 61 63 68 65 73 20 77 68 |of the c|aches wh|
|00005510| 65 6e 20 79 6f 75 20 62 | 6f 6f 74 2e 0d 4f 74 68 |en you b|oot..Oth|
|00005520| 65 72 20 66 61 63 74 6f | 72 73 20 74 68 61 74 20 |er facto|rs that |
|00005530| 61 66 66 65 63 74 20 74 | 68 65 20 65 71 75 61 74 |affect t|he equat|
|00005540| 69 6f 6e 20 6f 66 20 74 | 72 75 65 20 72 65 61 6c |ion of t|rue real|
|00005550| 20 74 69 6d 65 20 70 65 | 72 66 6f 72 6d 61 63 65 | time pe|rformace|
|00005560| 20 69 73 20 74 68 61 74 | 20 74 68 65 20 50 6f 72 | is that| the Por|
|00005570| 74 61 62 6c 65 20 69 73 | 20 61 20 36 38 30 30 30 |table is| a 68000|
|00005580| 20 77 69 74 68 20 61 6e | 20 38 20 62 69 74 20 62 | with an| 8 bit b|
|00005590| 75 73 2e 20 20 54 68 65 | 20 4d 61 63 20 49 49 20 |us. The| Mac II |
|000055a0| 69 73 20 61 20 36 38 30 | 32 30 20 77 69 74 68 20 |is a 680|20 with |
|000055b0| 61 20 31 36 20 62 69 74 | 20 62 75 73 2e 20 20 59 |a 16 bit| bus. Y|
|000055c0| 6f 75 20 63 61 6e 6e 6f | 74 20 65 71 75 61 74 65 |ou canno|t equate|
|000055d0| 20 74 68 65 20 72 61 74 | 69 6f 20 6f 66 20 61 20 | the rat|io of a |
|000055e0| 50 6f 72 74 61 62 6c 65 | 20 74 6f 20 61 20 4d 61 |Portable| to a Ma|
|000055f0| 63 20 49 49 20 62 61 73 | 65 64 20 6f 6e 20 54 69 |c II bas|ed on Ti|
|00005600| 6d 65 44 42 52 41 20 62 | 65 63 61 75 73 65 20 6f |meDBRA b|ecause o|
|00005610| 66 20 74 68 69 73 20 64 | 69 66 66 65 72 65 6e 63 |f this d|ifferenc|
|00005620| 65 2e 20 20 54 68 69 73 | 20 61 6c 73 6f 20 64 6f |e. This| also do|
|00005630| 65 73 20 6e 6f 74 20 63 | 6f 6e 73 69 64 65 72 20 |es not c|onsider |
|00005640| 68 6f 77 20 6d 75 63 68 | 20 74 69 6d 65 20 6f 74 |how much| time ot|
|00005650| 68 65 72 20 69 6e 74 65 | 72 72 75 70 74 73 20 61 |her inte|rrupts a|
|00005660| 72 65 20 74 61 6b 69 6e | 67 20 77 68 69 6c 65 20 |re takin|g while |
|00005670| 74 68 65 20 53 6f 75 6e | 64 20 4d 61 6e 61 67 65 |the Soun|d Manage|
|00005680| 72 20 69 73 20 72 75 6e | 6e 69 6e 67 2e 20 20 41 |r is run|ning. A|
|00005690| 6c 6c 20 6f 66 20 74 68 | 69 73 20 6c 65 61 64 73 |ll of th|is leads|
|000056a0| 20 74 6f 20 65 72 72 6f | 72 73 20 74 68 61 74 20 | to erro|rs that |
|000056b0| 67 65 74 20 6c 65 73 73 | 20 61 63 63 72 75 61 74 |get less| accruat|
|000056c0| 65 20 74 68 65 20 66 75 | 72 74 68 65 72 20 61 77 |e the fu|rther aw|
|000056d0| 61 79 20 66 72 6f 6d 20 | 61 20 4d 61 63 20 49 49 |ay from |a Mac II|
|000056e0| 20 79 6f 75 20 61 72 65 | 2e 20 20 54 68 65 20 65 | you are|. The e|
|000056f0| 78 61 6d 70 6c 65 20 62 | 65 69 6e 67 20 74 68 61 |xample b|eing tha|
|00005700| 74 20 74 68 65 20 53 6f | 75 6e 64 20 4d 61 6e 61 |t the So|und Mana|
|00005710| 67 65 72 20 64 6f 65 73 | 6e d5 74 20 74 68 69 6e |ger does|n.t thin|
|00005720| 6b 20 61 20 50 6f 72 74 | 61 62 6c 65 20 63 61 6e |k a Port|able can|
|00005730| 20 70 6c 61 79 20 4d 41 | 43 45 2c 20 62 75 74 20 | play MA|CE, but |
|00005740| 69 74 20 77 6f 72 6b 73 | 2e 20 20 20 54 68 65 20 |it works|. The |
|00005750| 65 72 72 6f 72 20 69 6e | 20 74 68 65 20 6f 74 68 |error in| the oth|
|00005760| 65 72 20 64 69 72 65 63 | 74 69 6f 6e 20 69 73 20 |er direc|tion is |
|00005770| 74 68 61 74 20 74 68 65 | 20 53 6f 75 6e 64 20 4d |that the| Sound M|
|00005780| 61 6e 61 67 65 72 20 62 | 65 6c 69 76 65 73 20 74 |anager b|elives t|
|00005790| 68 65 20 68 69 67 68 65 | 72 20 65 6e 64 20 6d 61 |he highe|r end ma|
|000057a0| 63 68 69 6e 65 73 20 63 | 61 6e 20 64 6f 20 6d 6f |chines c|an do mo|
|000057b0| 72 65 20 74 68 61 74 20 | 69 73 20 72 65 61 6c 6c |re that |is reall|
|000057c0| 79 20 70 6f 73 73 69 62 | 6c 65 2e 0d 46 69 6e 61 |y possib|le..Fina|
|000057d0| 6c 6c 79 20 74 68 65 20 | 62 69 67 67 65 73 74 20 |lly the |biggest |
|000057e0| 66 6c 61 77 20 77 69 74 | 68 20 74 68 65 20 69 64 |flaw wit|h the id|
|000057f0| 65 61 20 6f 66 20 68 61 | 76 69 6e 67 20 61 20 63 |ea of ha|ving a c|
|00005800| 61 6c 63 75 6c 61 74 69 | 6f 6e 20 64 72 69 76 65 |alculati|on drive|
|00005810| 6e 20 6d 65 74 68 6f 64 | 20 69 73 20 74 68 61 74 |n method| is that|
|00005820| 20 79 6f 75 20 63 61 6e | 20 6e 65 76 65 72 20 72 | you can| never r|
|00005830| 65 61 6c 6c 79 20 67 75 | 65 73 73 20 77 68 61 74 |eally gu|ess what|
|00005840| 20 77 69 6c 6c 20 62 65 | 20 68 61 70 70 65 6e 69 | will be| happeni|
|00005850| 6e 67 20 69 6e 20 72 65 | 61 6c 20 74 69 6d 65 2e |ng in re|al time.|
|00005860| 20 20 54 68 65 20 53 6f | 75 6e 64 20 4d 61 6e 61 | The So|und Mana|
|00005870| 67 65 72 d5 73 20 65 73 | 74 69 6d 61 74 69 6f 6e |ger.s es|timation|
|00005880| 73 20 61 72 65 20 61 6c | 77 61 79 73 20 62 61 73 |s are al|ways bas|
|00005890| 65 64 20 6f 6e 20 77 6f | 72 73 74 20 63 61 73 65 |ed on wo|rst case|
|000058a0| 2c 20 65 76 65 72 79 20 | 66 65 61 74 75 72 65 20 |, every |feature |
|000058b0| 6d 61 79 20 62 65 20 68 | 61 70 70 65 6e 69 6e 67 |may be h|appening|
|000058c0| 20 61 74 20 6f 6e 63 65 | 2e 20 20 20 53 6f 20 69 | at once|. So i|
|000058d0| 66 20 79 6f 75 20 6f 70 | 65 6e 20 61 20 63 68 61 |f you op|en a cha|
|000058e0| 6e 6e 65 6c 20 74 68 61 | 74 20 6d 61 79 20 70 6c |nnel tha|t may pl|
|000058f0| 61 79 20 61 20 4d 41 43 | 45 20 73 6f 75 6e 64 2c |ay a MAC|E sound,|
|00005900| 20 74 68 65 20 53 6f 75 | 6e 64 20 4d 61 6e 61 67 | the Sou|nd Manag|
|00005910| 65 72 20 61 73 73 75 6d | 65 73 20 74 68 61 74 20 |er assum|es that |
|00005920| 61 6c 6c 20 73 6f 75 6e | 64 73 20 77 69 6c 6c 20 |all soun|ds will |
|00005930| 62 65 20 63 6f 6d 70 72 | 65 73 73 65 64 2e 20 20 |be compr|essed. |
|00005940| 41 6e 64 20 69 66 20 79 | 6f 75 20 68 61 76 65 20 |And if y|ou have |
|00005950| 6f 74 68 65 72 20 63 68 | 61 6e 6e 65 6c 73 20 6f |other ch|annels o|
|00005960| 70 65 6e 2c 20 69 74 20 | 61 73 73 75 6d 65 73 20 |pen, it |assumes |
|00005970| 74 68 61 74 20 74 68 65 | 79 20 61 6c 6c 20 77 69 |that the|y all wi|
|00005980| 6c 6c 20 62 65 20 70 6c | 61 79 69 6e 67 20 61 74 |ll be pl|aying at|
|00005990| 20 74 68 65 20 73 61 6d | 65 20 74 69 6d 65 2e 20 | the sam|e time. |
|000059a0| 20 54 68 65 20 6d 6f 72 | 65 20 72 65 61 6c 69 73 | The mor|e realis|
|000059b0| 74 69 63 20 73 69 74 75 | 61 74 69 6f 6e 20 69 73 |tic situ|ation is|
|000059c0| 20 74 68 61 74 20 6d 6f | 73 74 20 6f 66 20 74 68 | that mo|st of th|
|000059d0| 65 20 74 69 6d 65 20 79 | 6f 75 20 77 69 6c 6c 20 |e time y|ou will |
|000059e0| 6e 6f 74 20 68 61 76 65 | 20 74 68 65 20 77 6f 72 |not have| the wor|
|000059f0| 73 74 20 63 61 73 65 20 | 73 65 6e 61 72 69 6f 2e |st case |senario.|
|00005a00| 20 20 41 20 62 65 74 74 | 65 72 20 61 70 70 72 6f | A bett|er appro|
|00005a10| 61 63 68 20 69 73 20 74 | 6f 20 74 65 73 74 20 66 |ach is t|o test f|
|00005a20| 6f 72 20 72 65 61 6c 20 | 74 69 6d 65 20 43 50 55 |or real |time CPU|
|00005a30| 20 6c 6f 61 64 69 6e 67 | 20 61 74 20 72 75 6e 20 | loading| at run |
|00005a40| 74 69 6d 65 2e 20 20 54 | 68 65 20 64 69 66 66 69 |time. T|he diffi|
|00005a50| 63 75 6c 74 79 20 62 65 | 69 6e 67 20 68 6f 77 20 |culty be|ing how |
|00005a60| 74 6f 20 68 61 6e 64 6c | 65 20 74 68 65 20 73 69 |to handl|e the si|
|00005a70| 74 75 61 74 69 6f 6e 20 | 6f 66 20 72 75 6e 6e 69 |tuation |of runni|
|00005a80| 6e 67 20 6f 75 74 20 6f | 66 20 72 65 61 6c 20 74 |ng out o|f real t|
|00005a90| 69 6d 65 2e 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ime..___|________|
|00005aa0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005ab0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 6e 75 6c 6c 43 6d |________|_.nullCm|
|00005ac0| 64 0d 70 61 72 61 6d 31 | 09 30 20 28 69 67 6e 6f |d.param1|.0 (igno|
|00005ad0| 72 65 64 20 6f 6e 20 69 | 6e 70 75 74 20 61 6e 64 |red on i|nput and|
|00005ae0| 20 6f 75 74 70 75 74 29 | 0d 70 61 72 61 6d 32 09 | output)|.param2.|
|00005af0| 30 20 28 69 67 6e 6f 72 | 65 64 20 6f 6e 20 69 6e |0 (ignor|ed on in|
|00005b00| 70 75 74 20 61 6e 64 20 | 6f 75 74 70 75 74 29 2e |put and |output).|
|00005b10| 0d 44 6f 65 73 20 6e 6f | 74 68 69 6e 67 2e 20 59 |.Does no|thing. Y|
|00005b20| 6f 75 20 63 61 6e 20 73 | 65 6e 64 20 6e 75 6c 6c |ou can s|end null|
|00005b30| 43 6d 64 20 74 6f 20 61 | 6e 79 20 6f 66 20 74 68 |Cmd to a|ny of th|
|00005b40| 65 20 61 76 61 69 6c 61 | 62 6c 65 20 73 79 6e 74 |e availa|ble synt|
|00005b50| 68 65 73 69 7a 65 72 73 | 2e 0d 5f 5f 5f 5f 5f 5f |hesizers|..______|
|00005b60| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005b70| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 0d 70 |________|______.p|
|00005b80| 61 75 73 65 43 6d 64 0d | 70 61 72 61 6d 31 09 30 |auseCmd.|param1.0|
|00005b90| 20 28 69 67 6e 6f 72 65 | 64 20 6f 6e 20 69 6e 70 | (ignore|d on inp|
|00005ba0| 75 74 20 61 6e 64 20 6f | 75 74 70 75 74 29 0d 70 |ut and o|utput).p|
|00005bb0| 61 72 61 6d 32 09 30 20 | 28 69 67 6e 6f 72 65 64 |aram2.0 |(ignored|
|00005bc0| 20 6f 6e 20 69 6e 70 75 | 74 20 61 6e 64 20 6f 75 | on inpu|t and ou|
|00005bd0| 74 70 75 74 29 2e 0d 50 | 61 75 73 65 73 20 61 6e |tput)..P|auses an|
|00005be0| 79 20 66 75 72 74 68 65 | 72 20 63 6f 6d 6d 61 6e |y furthe|r comman|
|00005bf0| 64 20 70 72 6f 63 65 73 | 73 69 6e 67 20 69 6e 20 |d proces|sing in |
|00005c00| 61 20 63 68 61 6e 6e 65 | 6c 20 75 6e 74 69 6c 20 |a channe|l until |
|00005c10| 72 65 73 75 6d 65 43 6d | 64 20 69 73 20 72 65 63 |resumeCm|d is rec|
|00005c20| 65 69 76 65 64 2e 20 59 | 6f 75 20 63 61 6e 20 73 |eived. Y|ou can s|
|00005c30| 65 6e 64 20 70 61 75 73 | 65 43 6d 64 20 74 6f 20 |end paus|eCmd to |
|00005c40| 61 6e 79 20 6f 66 20 74 | 68 65 20 61 76 61 69 6c |any of t|he avail|
|00005c50| 61 62 6c 65 20 73 79 6e | 74 68 65 73 69 7a 65 72 |able syn|thesizer|
|00005c60| 73 2e 20 0d 4e 6f 74 65 | 73 0d 59 6f 75 20 6d 75 |s. .Note|s.You mu|
|00005c70| 73 74 20 75 73 65 20 53 | 6e 64 44 6f 49 6d 6d 65 |st use S|ndDoImme|
|00005c80| 64 69 61 74 65 20 69 73 | 73 75 69 6e 67 20 61 20 |diate is|suing a |
|00005c90| 72 65 73 75 6d 65 43 6d | 64 20 74 6f 20 63 61 75 |resumeCm|d to cau|
|00005ca0| 73 65 20 74 68 65 20 63 | 68 61 6e 6e 65 6c 20 74 |se the c|hannel t|
|00005cb0| 6f 20 63 6f 6e 74 69 6e | 75 65 2e 20 20 41 6e 79 |o contin|ue. Any|
|00005cc0| 20 6f 74 68 65 72 20 63 | 6f 6d 6d 61 6e 64 20 73 | other c|ommand s|
|00005cd0| 65 6e 74 20 62 79 20 53 | 6e 64 44 6f 49 6d 6d 65 |ent by S|ndDoImme|
|00005ce0| 64 69 61 74 65 20 77 69 | 6c 6c 20 63 61 75 73 65 |diate wi|ll cause|
|00005cf0| 20 61 6e 20 65 72 72 6f | 72 20 74 6f 20 72 65 73 | an erro|r to res|
|00005d00| 75 6c 74 2e 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ult..___|________|
|00005d10| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005d20| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 70 68 61 73 65 43 |________|_.phaseC|
|00005d30| 6d 64 0d 54 68 69 73 20 | 63 6f 6d 6d 61 6e 64 20 |md.This |command |
|00005d40| 69 73 20 73 65 6e 74 20 | 62 79 20 61 70 70 6c 69 |is sent |by appli|
|00005d50| 63 61 74 69 6f 6e 73 2e | 20 20 49 74 20 69 73 20 |cations.| It is |
|00005d60| 6f 6e 6c 79 20 75 73 65 | 64 20 62 79 20 74 68 65 |only use|d by the|
|00005d70| 20 77 61 76 65 20 74 61 | 62 6c 65 20 73 79 6e 74 | wave ta|ble synt|
|00005d80| 68 65 73 69 7a 65 72 20 | 74 6f 20 73 79 6e 63 68 |hesizer |to synch|
|00005d90| 72 6f 6e 69 7a 65 20 74 | 68 65 20 70 68 61 73 65 |ronize t|he phase|
|00005da0| 73 20 6f 66 20 74 68 65 | 20 77 61 76 65 20 63 79 |s of the| wave cy|
|00005db0| 63 6c 65 73 20 61 63 72 | 6f 73 73 20 64 69 66 66 |cles acr|oss diff|
|00005dc0| 65 72 65 6e 74 20 77 61 | 76 65 20 74 61 62 6c 65 |erent wa|ve table|
|00005dd0| 20 63 68 61 6e 6e 65 6c | 73 2e 20 20 41 73 20 61 | channel|s. As a|
|00005de0| 6e 20 65 78 61 6d 70 6c | 65 2c 20 69 66 20 74 77 |n exampl|e, if tw|
|00005df0| 6f 20 77 61 76 65 20 74 | 61 62 6c 65 20 63 68 61 |o wave t|able cha|
|00005e00| 6e 6e 65 6c 73 20 63 6f | 6e 74 61 69 6e 69 6e 67 |nnels co|ntaining|
|00005e10| 20 74 68 65 20 73 61 6d | 65 20 77 61 76 65 20 63 | the sam|e wave c|
|00005e20| 79 63 6c 65 20 77 65 72 | 65 20 73 65 6e 74 20 74 |ycle wer|e sent t|
|00005e30| 68 65 20 73 61 6d 65 20 | 6e 6f 74 65 43 6d 64 2c |he same |noteCmd,|
|00005e40| 20 74 68 65 79 20 63 6f | 75 6c 64 20 6e 6f 74 20 | they co|uld not |
|00005e50| 62 65 67 69 6e 20 65 78 | 61 63 74 6c 79 20 61 74 |begin ex|actly at|
|00005e60| 20 74 68 65 20 73 61 6d | 65 20 74 69 6d 65 2e 20 | the sam|e time. |
|00005e70| 20 54 68 65 72 65 66 6f | 72 65 2c 20 74 6f 20 73 | Therefo|re, to s|
|00005e80| 79 6e 63 68 72 6f 6e 69 | 7a 65 20 74 68 65 20 77 |ynchroni|ze the w|
|00005e90| 61 76 65 20 63 79 63 6c | 65 73 20 66 6f 72 20 74 |ave cycl|es for t|
|00005ea0| 68 65 73 65 20 74 77 6f | 20 63 68 61 6e 6e 65 6c |hese two| channel|
|00005eb0| 73 20 74 68 65 20 70 68 | 61 73 65 43 6d 64 20 69 |s the ph|aseCmd i|
|00005ec0| 73 20 73 65 6e 74 2e 0d | 54 68 69 73 20 70 72 65 |s sent..|This pre|
|00005ed0| 76 65 6e 74 73 20 74 68 | 65 20 70 68 61 73 69 6e |vents th|e phasin|
|00005ee0| 67 20 65 66 66 65 63 74 | 73 20 6f 66 20 70 6c 61 |g effect|s of pla|
|00005ef0| 79 69 6e 67 20 74 77 6f | 20 73 69 6d 69 6c 61 72 |ying two| similar|
|00005f00| 20 77 61 76 65 73 20 74 | 6f 67 65 74 68 65 72 20 | waves t|ogether |
|00005f10| 61 74 20 74 68 65 20 73 | 61 6d 65 20 70 69 74 63 |at the s|ame pitc|
|00005f20| 68 2e 20 20 54 68 65 20 | 63 68 61 6e 6e 65 6c 20 |h. The |channel |
|00005f30| 77 69 6c 6c 20 68 61 76 | 65 20 69 74 73 20 77 61 |will hav|e its wa|
|00005f40| 76 65 20 73 68 69 66 74 | 65 64 20 62 79 20 74 68 |ve shift|ed by th|
|00005f50| 65 20 61 6d 6f 75 6e 74 | 20 73 70 65 63 69 66 69 |e amount| specifi|
|00005f60| 65 64 20 69 6e 20 73 68 | 69 66 74 20 74 6f 20 63 |ed in sh|ift to c|
|00005f70| 6f 72 72 65 73 70 6f 6e | 64 20 77 69 74 68 20 74 |orrespon|d with t|
|00005f80| 68 65 20 77 61 76 65 d5 | 73 20 70 68 61 73 65 20 |he wave.|s phase |
|00005f90| 69 6e 20 74 68 65 20 63 | 68 61 6e 6e 65 6c 20 73 |in the c|hannel s|
|00005fa0| 70 65 63 69 66 69 65 64 | 20 69 6e 20 70 61 72 61 |pecified| in para|
|00005fb0| 6d 32 2e 20 20 54 68 65 | 20 73 68 69 66 74 20 76 |m2. The| shift v|
|00005fc0| 61 6c 75 65 20 69 73 20 | 61 20 31 36 20 62 69 74 |alue is |a 16 bit|
|00005fd0| 20 66 72 61 63 74 69 6f | 6e 20 67 6f 69 6e 67 20 | fractio|n going |
|00005fe0| 66 72 6f 6d 20 7a 65 72 | 6f 20 74 6f 20 6f 6e 65 |from zer|o to one|
|00005ff0| 2e 20 20 54 68 65 20 76 | 61 6c 75 65 20 6f 66 20 |. The v|alue of |
|00006000| 24 38 30 30 30 20 77 6f | 75 6c 64 20 62 65 20 74 |$8000 wo|uld be t|
|00006010| 68 65 20 68 61 6c 66 2d | 77 61 79 20 70 6f 69 6e |he half-|way poin|
|00006020| 74 20 6f 66 20 74 68 65 | 20 77 61 76 65 20 63 79 |t of the| wave cy|
|00006030| 63 6c 65 2e 20 20 47 65 | 6e 65 72 61 6c 6c 79 2c |cle. Ge|nerally,|
|00006040| 20 74 68 65 20 65 66 66 | 65 63 74 73 20 66 72 6f | the eff|ects fro|
|00006050| 6d 20 74 68 69 73 20 63 | 6f 6d 6d 61 6e 64 20 77 |m this c|ommand w|
|00006060| 69 6c 6c 20 6e 6f 74 20 | 62 65 20 6e 6f 74 69 63 |ill not |be notic|
|00006070| 65 64 2e 0d 4e 6f 74 65 | 73 0d 54 68 69 73 20 63 |ed..Note|s.This c|
|00006080| 6f 6d 6d 61 6e 64 20 68 | 61 73 20 6e 65 76 65 72 |ommand h|as never|
|00006090| 20 62 65 65 6e 20 69 6d | 70 6c 65 6d 65 6e 74 65 | been im|plemente|
|000060a0| 64 2e 20 20 49 20 68 61 | 76 65 20 73 74 72 6f 6e |d. I ha|ve stron|
|000060b0| 67 20 64 6f 75 62 74 73 | 20 74 68 61 74 20 69 74 |g doubts| that it|
|000060c0| 20 63 6f 75 6c 64 20 61 | 63 74 75 61 6c 6c 79 20 | could a|ctually |
|000060d0| 62 65 20 61 63 63 6f 6d | 70 6c 69 73 68 65 64 2c |be accom|plished,|
|000060e0| 20 61 6e 64 20 65 76 65 | 6e 20 73 6f 20 49 20 64 | and eve|n so I d|
|000060f0| 6f 75 62 74 20 74 68 61 | 74 20 69 74 20 63 6f 75 |oubt tha|t it cou|
|00006100| 6c 64 20 62 65 20 63 6f | 6e 74 72 6f 6c 6c 65 64 |ld be co|ntrolled|
|00006110| 20 61 63 63 75 72 61 74 | 65 6c 79 20 65 6e 6f 75 | accurat|ely enou|
|00006120| 67 68 20 74 6f 20 70 72 | 6f 70 65 72 6c 79 20 64 |gh to pr|operly d|
|00006130| 6f 20 74 68 65 20 6a 6f | 62 2e 20 20 54 68 65 72 |o the jo|b. Ther|
|00006140| 65 66 6f 72 65 20 74 68 | 69 73 20 63 6f 6d 6d 61 |efore th|is comma|
|00006150| 6e 64 20 68 61 73 20 61 | 6c 6d 6f 73 74 20 6e 6f |nd has a|lmost no|
|00006160| 20 68 6f 70 65 20 6f 66 | 20 65 76 65 72 20 62 65 | hope of| ever be|
|00006170| 69 6e 67 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 2e |ing impl|emented.|
|00006180| 0d 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |._______|________|
|00006190| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000061a0| 5f 5f 5f 5f 5f 0d 71 75 | 69 65 74 43 6d 64 0d 70 |_____.qu|ietCmd.p|
|000061b0| 61 72 61 6d 31 09 30 20 | 28 69 67 6e 6f 72 65 64 |aram1.0 |(ignored|
|000061c0| 20 6f 6e 20 69 6e 70 75 | 74 20 61 6e 64 20 6f 75 | on inpu|t and ou|
|000061d0| 74 70 75 74 29 0d 70 61 | 72 61 6d 32 09 30 20 28 |tput).pa|ram2.0 (|
|000061e0| 69 67 6e 6f 72 65 64 20 | 6f 6e 20 69 6e 70 75 74 |ignored |on input|
|000061f0| 20 61 6e 64 20 6f 75 74 | 70 75 74 29 2e 0d 53 74 | and out|put)..St|
|00006200| 6f 70 73 20 74 68 65 20 | 73 6f 75 6e 64 20 74 68 |ops the |sound th|
|00006210| 61 74 20 69 73 20 63 75 | 72 72 65 6e 74 6c 79 20 |at is cu|rrently |
|00006220| 70 6c 61 79 69 6e 67 2e | 20 59 6f 75 20 63 61 6e |playing.| You can|
|00006230| 20 73 65 6e 64 20 71 75 | 69 65 74 43 6d 64 20 74 | send qu|ietCmd t|
|00006240| 6f 20 61 6e 79 20 6f 66 | 20 74 68 65 20 61 76 61 |o any of| the ava|
|00006250| 69 6c 61 62 6c 65 20 73 | 79 6e 74 68 65 73 69 7a |ilable s|ynthesiz|
|00006260| 65 72 73 2c 20 62 75 74 | 20 79 6f 75 20 73 68 6f |ers, but| you sho|
|00006270| 75 6c 64 20 73 65 6e 64 | 20 69 74 20 62 79 20 75 |uld send| it by u|
|00006280| 73 69 6e 67 20 53 6e 64 | 44 6f 49 6d 6d 65 64 69 |sing Snd|DoImmedi|
|00006290| 61 74 65 2e 0d 53 79 73 | 74 65 6d 20 36 2e 30 2e |ate..Sys|tem 6.0.|
|000062a0| 37 0d 54 68 65 20 71 75 | 69 65 74 43 6d 64 20 77 |7.The qu|ietCmd w|
|000062b0| 69 6c 6c 20 71 75 69 65 | 74 20 74 68 65 20 63 75 |ill quie|t the cu|
|000062c0| 72 72 65 6e 74 6c 79 20 | 73 6f 75 6e 64 69 6e 67 |rrently |sounding|
|000062d0| 20 6e 6f 74 65 20 6f 72 | 20 62 75 66 66 65 72 2c | note or| buffer,|
|000062e0| 20 62 75 74 20 69 74 20 | 77 69 6c 6c 20 6e 6f 74 | but it |will not|
|000062f0| 20 72 65 6d 6f 76 65 20 | 74 68 65 20 66 72 65 71 | remove |the freq|
|00006300| 44 75 72 61 74 69 6f 6e | 43 6d 64 d5 73 20 70 65 |Duration|Cmd.s pe|
|00006310| 6e 64 69 6e 67 20 64 75 | 72 61 74 69 6f 6e 2e 20 |nding du|ration. |
|00006320| 20 41 73 20 61 6e 20 65 | 78 61 6d 70 6c 65 2c 20 | As an e|xample, |
|00006330| 69 66 20 79 6f 75 20 69 | 73 73 75 65 20 61 20 6e |if you i|ssue a n|
|00006340| 6f 74 65 43 6d 64 20 77 | 69 74 68 20 61 20 64 75 |oteCmd w|ith a du|
|00006350| 72 61 74 69 6f 6e 20 6f | 66 20 31 36 20 73 65 63 |ration o|f 16 sec|
|00006360| 6f 6e 64 73 2c 20 61 6e | 64 20 74 68 65 20 66 6f |onds, an|d the fo|
|00006370| 6c 6c 6f 77 20 74 68 69 | 73 20 62 79 20 61 20 53 |llow thi|s by a S|
|00006380| 6e 64 44 6f 49 6d 6d 65 | 64 69 61 74 65 20 6f 66 |ndDoImme|diate of|
|00006390| 20 61 20 71 75 69 65 74 | 43 6d 64 20 74 68 65 20 | a quiet|Cmd the |
|000063a0| 53 6f 75 6e 64 20 4d 61 | 6e 61 67 65 72 20 77 69 |Sound Ma|nager wi|
|000063b0| 6c 6c 20 6e 6f 74 20 70 | 72 6f 63 65 73 73 20 74 |ll not p|rocess t|
|000063c0| 68 65 20 6e 65 78 74 20 | 63 6f 6d 6d 61 6e 64 20 |he next |command |
|000063d0| 69 6e 20 74 68 65 20 63 | 68 61 6e 6e 65 6c 20 75 |in the c|hannel u|
|000063e0| 6e 74 69 6c 20 74 68 65 | 20 6f 72 69 67 69 6e 61 |ntil the| origina|
|000063f0| 6c 20 6e 6f 74 65 43 6d | 64 d5 73 20 64 75 72 61 |l noteCm|d.s dura|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.